Copertine e giochi ben ordinati: la guida allo scraping

Trecent giochi su una scheda microSD danno vita a un elenco di trecento righe di testo. Tra cui smb3.zip, Super Mario Bros. 3 (USA).zip e SMB3 (fr).zip, e ormai nessuno sa quale avviare. Lo scraping risolve il problema: uno strumento interroga un database online, riconosce ogni file e recupera la copertina, il titolo corretto, l'anno, l'editore e a volte un video.

Il risultato è visivo, ma l'interesse risiede altrove: una libreria sottoposta a scraping diventa ordinabile e ricercabile per genere, anno e valutazione, e i duplicati saltano subito agli occhi. Su una console che si accende per dieci minuti sul treno, questo risparmio di tempo conta più della bellezza delle immagini.

Cosa recupera realmente lo scraping

Uno scraper non «legge» il tuo gioco. Invia a un database online il nome del file, la sua dimensione e un'impronta digitale (CRC, MD5 o SHA-1); il database risponde con la scheda corrispondente. Viene trasmessa solo la firma, non il gioco.

Il database più utilizzato per le console portatili è ScreenScraper.fr, alimentato da contributori volontari e ricco di copertine europee. TheGamesDB e ArcadeDB fungono da riserva su alcuni firmware.

È necessario un account ScreenScraper gratuito: gli scraper di KNULLI e ROCKNIX richiedono entrambi nome utente e password. Questo account ha limiti di velocità e volume giornaliero, mentre i contributori ottengono più connessioni di download simultanee. Per centinaia di titoli, calcola diversi cicli.

La nomenclatura dei file determina tutto il resto

Questa è la parte che si tende a saltare e di cui poi ci si pente. Uno scraper identifica un gioco tramite la sua impronta digitale quando è nota, altrimenti tramite il nome del file. Non appena un file viene ricompresso, convertito, patchato o rinominato manualmente, l'impronta non corrisponde più a nulla e rimane solo il nome.

Ecco la regola: mantieni i nomi derivanti dalle convenzioni di catalogazione standard, quelle dei progetti No-Intro per le cartucce e Redump per i dischi. Seguono il formato Nome del gioco (Regione) (Lingue) [flag].ext. La documentazione di KNULLI lo afferma chiaramente: lo scraper cerca a partire dal nome del file, e le indicazioni regionali come (USA) o (Europe) aiutano a scegliere tra diverse edizioni.

Cosa compromette il riconoscimento

• Abbreviazioni personalizzate: ff7.chd non dice nulla a nessuno.
• Numeri di ordinamento come prefisso: 01 - Chrono Trigger.sfc riducono il tasso di successo.
• Caratteri esotici, che causano anche problemi di lettura su FAT32.
• Giochi modificati dai fan: la loro impronta è unica e nessun database li conosce. Dovranno essere illustrati manualmente.
• Giochi multi-disco suddivisi in (Disc 1) e (Disc 2), che generano più voci anziché una.

Correggere la nomenclatura prima dello scraping evita la stragrande maggioranza delle copertine mancanti. Un'ora di rinomina corretta vale meglio di tre passaggi.

Scraping dalla console: i firmware basati su EmulationStation

KNULLI, ROCKNIX, Batocera e ArkOS si basano su EmulationStation e includono uno scraper. È il metodo più semplice: la console fa tutto.

Su KNULLI, si preme Start per aprire il menu principale, quindi si entra in Scraper. Sono proposte tre fonti: ScreenScraper (predefinita), TheGamesDB e ArcadeDB. Qui si scelgono i media — copertina 2D o 3D, logo, video, valutazione della community, manuale, descrizione —, la regione preferita e il comportamento in caso di dati già presenti. Una sezione di filtri consente di elaborare un sistema alla volta o di ignorare i giochi sottoposti a scraping di recente: indispensabile per una grande libreria.

Su ROCKNIX, la procedura è identica: Start, menu principale, Scraper. La documentazione ufficiale menziona solo ScreenScraper, con l'inserimento delle credenziali e poi le caselle da spuntare per le risorse da scaricare.

In entrambi i casi, lascia la console collegata alla corrente: lo scraping di centinaia di giochi con video può tenere occupato il dispositivo per gran parte della notte. Se hai ancora dubbi sul firmware, la nostra guida ai firmware personalizzati muOS, KNULLI, ArkOS, ROCKNIX e Batocera confronta le loro caratteristiche.

Scraping da computer: Skraper e Skyscraper

Il PC diventa necessario in due casi: firmware senza scraper integrato o desiderio di comporre le proprie immagini.

Skraper è lo strumento grafico di riferimento: gratuito, basato su ScreenScraper, nativo per Windows e Linux, e su macOS solo tramite WINE o CrossOver, senza supporto ufficiale. La versione pubblicata ad oggi è la 1.4.1. Si indica la cartella delle ROM, la cartella di destinazione e il formato delle immagini, e lo strumento elabora l'intera scheda.

È quello consigliato dalle guide di configurazione delle Anbernic con firmware originale, con la cartella di destinazione impostata su %ROMROOTFOLDER%\Imgs\.

Skyscraper è il suo equivalente da riga di comando, molto più configurabile. Attenzione al repository: il progetto originale di Lars Muldjord non è più mantenuto, l'autore avverte che alcune interfacce dei database potrebbero essere obsolete e rimanda al fork della community di Gemba, attivo dall'autunno 2023. È questa la versione da installare; gira ufficialmente su Linux e funziona anche su macOS e Windows senza supporto ufficiale, con l'ultima pubblicazione 3.21.1 dell'11 ottobre 2026.

Prevedi spazio prima di avviare l'operazione: una scheda piena provoca scritture incomplete. La nostra guida per scegliere la scheda microSD illustra le capacità utili.

I firmware senza EmulationStation

muOS non contiene uno scraper integrato. La sua documentazione è esplicita: le immagini vengono caricate manualmente o generate con uno strumento di terze parti. Due strumenti sono progettati per esso.

• Artie gira direttamente sulla console, senza PC dopo l'installazione. Preleva i dati da ScreenScraper, richiede le tue credenziali al primo avvio, dichiara più di cento sistemi supportati e organizza i file nel catalogo muOS. Versione 4.1.0 dell'11 maggio 2026.
• Scrappy include Skyscraper in un'applicazione muOS e compone immagini a partire da modelli XML. Verifica sulla sua pagina che supporti la tua versione di muOS.

OnionOS, su Miyoo Mini, offre entrambe le opzioni: un'applicazione Scraper integrata, più lenta sulle grandi collezioni, e Skraper da computer, più veloce.

I firmware originali delle Anbernic H700 e delle TrimUI, invece, generalmente non integrano uno scraper: usa il PC.

Quale strumento per quale firmware

Scegliere il tipo di immagini e lo spazio che occupa

I database offrono diversi media per lo stesso gioco, ed è qui che la scheda si riempie senza che ce ne accorgiamo.

• La copertina 2D è la scelta predefinita: leggibile anche in piccolo, immediatamente riconoscibile, è quella che rende meglio su uno schermo da 3,5 pollici.
• La scatola 3D è più bella su uno schermo grande, ma il suo testo diventa illeggibile in miniatura.
• La schermata iniziale esiste per quasi tutto, inclusi i titoli arcade e quelli giapponesi senza copertina indicizzata.
• Lo screenshot di gioco informa sullo stile grafico, ma in miniatura sono tutti simili.
• Il logo (spesso chiamato wheel) serve come sovrapposizione in alcuni temi, non come miniatura principale.
• I video sono l'unico media davvero pesante. Mentre una copertina PNG di piccole dimensioni si conta in decine di kilobyte, un video si conta in megabyte per gioco. Su trecento titoli, la differenza si misura in gigabyte.

Il nostro consiglio: solo copertina 2D al primo passaggio, schermata iniziale come riserva per il resto, video solo se hai spazio e una console abbastanza veloce da riprodurli senza scatti.

Dove finiscono le immagini

Il principio è semplice, anche se ogni famiglia ha la sua variante. I firmware basati su EmulationStation scrivono un gamelist.xml per sistema, accanto ai giochi, e organizzano i media in una cartella di sottolivello adiacente. L'XML fa da collegamento tra ogni gioco e la sua immagine: è lui a contenere la libreria, non le immagini.

muOS funziona diversamente, con un catalogo centralizzato in MUOS/info/catalogue/: una cartella per sistema, e in particolare box, preview e text. Il nome dell'immagine deve riprodurre esattamente quello del gioco, a parte l'estensione.

OnionOS e i firmware originali si aspettano una cartella Imgs accanto alle ROM di ogni sistema — con una I maiuscola su Onion, la distinzione tra maiuscole e minuscole è importante.

Per i percorsi esatti, sistema per sistema e firmware per firmware, consulta il nostro articolo su l'albero delle cartelle a seconda del firmware: la tabella è già lì, inutile riscriverla qui.

I temi dell'interfaccia

Un tema decide cosa vedi: griglia di copertine, elenco con miniatura laterale, scheda dettagliata con logo e descrizione. Di conseguenza pratica, può richiedere un media che non hai sottoposto a scraping — una griglia di scatole 3D rimarrà vuota se hai recuperato solo copertine 2D. Verifica cosa si aspetta prima di preoccuparti per una visualizzazione incompleta.

Su Batocera, un downloader di temi è integrato nel menu Updates & Downloads, sezione Themes; i firmware derivati ne beneficiano. La documentazione consiglia di verificare i problemi segnalati su un tema prima di applicarlo: le incompatibilità esistono. Su muOS e OnionOS, i temi si scaricano dalle rispettive community e vengono depositati nella cartella prevista.

Risoluzione dei problemi

Manca una copertina

Segui l'ordine: verifica il nome del file, avvia un altro scraping mirato solo su questo titolo, cambia fonte se il firmware ne propone diverse, poi la regione preferita. Se il gioco è stato modificato dai fan, nessun database lo conosce: aggiungi l'immagine manualmente, riprendendo alla lettera il nome del file di gioco.

La copertina visualizzata non è quella giusta

È quasi sempre un problema di edizione: un file senza indicazione di regione cade sulla prima corrispondenza disponibile. Aggiungi (Europe) o (USA), cancella la scheda esistente, quindi riscraping solo questo gioco. Su EmulationStation, i metadati si modificano dalla scheda del gioco, e un'opzione protegge le tue correzioni manuali durante gli scraping successivi.

L'elenco mostra duplicati

Tre cause classiche. I giochi multi-disco presenti in più file, la cui raggruppamento passa per un file di elenco unico. L'archivio e il suo contenuto sono entrambi visibili, quando jeu.zip e jeu.sfc coesistono: tieni solo una forma. Infine un gamelist.xml ereditato da un'installazione precedente, che descrive giochi assenti: eliminalo e avvia uno scraping completo.

Se il problema non è l'immagine ma il gioco che si rifiuta di avviarsi, la causa è altrove: il nostro articolo il mio gioco non si avvia, 14 cause passa le verifiche in ordine.

Un ultimo punto hardware. Lo scraping scrive migliaia di piccoli file, ed è l'uso che svela le schede microSD contraffatte: la copia sembra avvenire, poi le immagini scompaiono o si visualizzano corrotte. Se la tua ti ispira un dubbio, consulta la nostra sezione schede microSD.