Pubblicato un nuovo aggiornamento per RomM (ROM Manager), il gestore di ROM self-hosted capace di organizzare, arricchire e riprodurre giochi per emulatori in modo centralizzato.

Tra le novità più importanti c’è l’aggiornamento dell’endpoint del Tinfoil feed, che passa da /tinfoil/feed a /feeds/tinfoil; gli utenti devono aggiornare la configurazione per continuare a usare correttamente questa fonte di metadati.

Inoltre, è necessario eseguire manualmente un aggiornamento programmato dei metadati di LaunchBox prima di poter utilizzare questa fonte.

RomM amplia la gestione delle cover e dei media grazie all’integrazione con Screenscraper, permettendo di scaricare cover 2D e 3D, immagini miste, boxart fisiche, screenshot, manuali in PDF, title screen, loghi, fanart e persino video di gameplay.

L’utente può configurare quali tipologie di media scaricare tramite il file config.yml e applicare stili differenti come 3D, Physical o Mix Image. La libreria può ora importare anche i file gamelist.xml di EmulationStation e ES-DE, associando correttamente le risorse multimediali a ciascun gioco.

La nuova pagina di stato dei task consente di monitorare in tempo reale tutte le operazioni in background, mostrando statistiche sulle attività completate e messaggi di errore per eventuali task falliti.

Il multi-threaded scanning permette di analizzare più giochi contemporaneamente, riducendo significativamente i tempi di scansione delle grandi librerie.

Il numero di processi paralleli può essere regolato tramite la variabile d’ambiente SCAN_WORKERS, pur restando limitato dalle capacità della CPU e dalle connessioni ai provider di metadati.

La gestione dei metadati è stata ulteriormente migliorata: l’utente può modificare direttamente gli ID dei metadati e i valori JSON associati a ciascun gioco, aggiornando informazioni come i video gameplay o altri asset multimediali.

Tuttavia, gli aggiornamenti completi o parziali di un gioco sovrascriveranno eventuali modifiche manuali.

Aggiunto il supporto ai feed PKGi e Kekatsu, consentendo l’integrazione diretta con strumenti di download per PS3, PSP, PS Vita e Nintendo DS, coprendo giochi, DLC, demo, patch, aggiornamenti, mod, traduzioni e prototipi.

Lo scanner ora può confrontare le ROM con il database hash di Screenscraper, riducendo gli errori di riconoscimento in caso di file con nomi non standard o multipli.

Numerosi fix minori migliorano la stabilità e la leggibilità dell’interfaccia, tra cui la validazione delle date di rilascio, la gestione degli errori nella cancellazione delle ROM, il supporto multi-file e la correzione dei task pendenti.

L’interfaccia utente è stata affinata con opzioni per filtrare le collezioni, visualizzare le playlist e impostare la pagina iniziale, oltre a miglioramenti nella navigazione, nella gestione degli shortcut e nella visualizzazione dei widget.

Infine, sono state introdotte nuove variabili d’ambiente, tra cui TASK_RESULT_TTL per la durata dei risultati dei task e SEVEN_ZIP_TIMEOUT per le operazioni 7-Zip.

L’API è stata aggiornata con la distinzione tra configurazioni montate e scrivibili, la rinomina di campi relativi ai preferiti e la gestione più accurata delle collezioni e dei metadati delle ROM.

Caratteristiche

• Scansiona e arricchisci la tua libreria di giochi con metadati da IGDB, Screenscraper e MobyGames.
• Recupera artwork personalizzati da SteamGridDB.
• Mostra i tuoi achievement da Retroachievements.
• Metadati disponibili per oltre 400 piattaforme.
• Gioca direttamente dal browser usando EmulatorJS e RuffleRS.
• Condividi la tua libreria con gli amici con accesso e permessi limitati.
• App ufficiali per Playnite e muOS.
• Supporta giochi multi-disco, DLC, mod, hack, patch e manuali.
• Analizza e filtra tramite tag nei nomi dei file.
• Visualizza, carica, aggiorna ed elimina giochi da qualsiasi browser moderno.

L’installazione di RomM è resa accessibile soprattutto tramite Docker, con una configurazione guidata che include la gestione dei database MariaDB, le chiavi API per il recupero dei metadati e la strutturazione delle cartelle delle ROM.

Per gli utenti meno esperti, l’interfaccia web permette il caricamento drag-and-drop e la scansione automatica dei file. La comunità gioca anche un ruolo fondamentale, con oltre 3.600 membri attivi su Discord che contribuiscono con progetti complementari come bot, client Electron e app Android.

RomM si inserisce inoltre in un ecosistema più ampio di strumenti per il retrogaming, con integrazioni interessanti come Steam ROM Manager, RetroDECK e altri gestori compatibili con diverse piattaforme, permettendo una gestione unificata dei giochi moderni e retrò.

Grazie alla combinazione di organizzazione avanzata, arricchimento dei metadati, riproduzione browser-based e supporto comunitario, RomM rappresenta oggi una soluzione completa e indispensabile per chi desidera vivere e condividere la propria passione per il retrogaming con un alto grado di personalizzazione e controllo.

Changelog

Alternative Boxart

L’aggiornamento introduce la possibilità di arricchire la propria collezione con boxart in 3D, fisiche e miste, grazie a Screenscraper. Per iniziare, è necessario configurare quali risorse multimediali scaricare all’interno del file config.yml, sotto la sezione scan: media. I tipi di media disponibili sono:

• box2d: cover art normale (sempre abilitata)
• box3d: box art in 3D
• miximage: immagine mista di più media
• physical: disco, cartuccia, ecc.
• screenshot: screenshot (abilitato di default)
• title_screen: schermata del titolo
• marquee: marquee personalizzato
• logo: logo trasparente
• fanart: artwork caricato dall’utente
• bezel: cornice visualizzata attorno alla finestra di EmulatorJS
• manual: manuale in formato PDF (abilitato di default)
• video: video di gameplay (attenzione: dimensioni elevate)

Dopo aver configurato il tutto, occorre riavviare il container. Nella pagina di scansione, selezionare Screenscraper come fonte dei metadata, impostare Update metadata come tipo di scansione e cliccare sul pulsante Scan.

I media selezionati verranno scaricati e salvati insieme alle risorse già esistenti per cover e screenshot.

Infine, nella sezione User Interface (/user-interface), sarà possibile modificare lo stile della boxart scegliendo tra 3D, Physical o Mix Image a seconda delle preferenze.

Supporto ES-DE gamelist.xml

RomM ora supporta il formato XML personalizzato utilizzato da EmulationStation e dal suo successore ES-DE per memorizzare i metadata dei giochi.

Il software è in grado di interpretare questi file e importare le risorse come cover e screenshot, è necessario posizionare il file gamelist.xml e le risorse correlate all’interno della cartella della piattaforma e selezionare ES-DE nel menu a tendina “Metadata sources” nella pagina di scansione.

Esempio di struttura della cartella:

library/
  └─ roms/
    └─ gba/
      ├─ game_1.gba
      ├─ game_2.gba
      ├─ gamelist.xml
      ├─ 3dboxes/
      │  ├─ game_1.png
      │  └─ game_2.png
      ├─ covers/
      ├─ screenshots/
      └─ etc...

Il parser supporta numerosi campi XML, tra cui percorso, nome, descrizione, valutazione, data di rilascio, sviluppatore, publisher, genere, numero di giocatori, video, cover 3D, copertina posteriore, cover standard, fanart, manuale, marquee, immagine mista, media fisico, screenshot, schermata del titolo e thumbnail.

Task status page

Aggiunta una nuova sezione nella pagina /administration per monitorare i task in background. La sezione mostra lo stato dei task in tempo reale, le statistiche di esecuzione per quelli completati con successo e i messaggi di errore per quelli falliti.

Scansione della libreria multi-threaded

Ora è possibile scansionare più giochi della stessa piattaforma in parallelo, riducendo significativamente il tempo necessario per librerie di grandi dimensioni.

Il numero di giochi scansionati in parallelo può essere configurato tramite la variabile ambiente SCAN_WORKERS. La scansione parallela dipende dalle prestazioni della CPU e dal numero massimo di connessioni consentite ai fornitori di metadata.

Modifica manuale dei metadata

La finestra di modifica dei giochi ora permette di modificare direttamente gli ID dei metadata e i valori JSON. La modifica di un ID forza il server a recuperare i metadata da quella fonte con il nuovo ID.

I valori JSON possono essere modificati direttamente e salvati come metadata grezzi, ad esempio aggiornando youtube_video_id per usare video di gameplay al posto dei trailer. Nota: una scansione di tipo UPDATE o COMPLETE sovrascriverà eventuali modifiche manuali.

Supporto feed PKGi e Kekatsu per PS3/PSVita/PSP e DS

Aggiunti i formati feed PKGi e Kekatsu, permettendo l’integrazione diretta con i principali strumenti di download di giochi:

• PKGi PS3: Giochi, DLC, demo, aggiornamenti, patch, mod, traduzioni e prototipi.
• PKGi PSP: Supporto agli stessi tipi di contenuti.
• PKGi PS Vita: Supporto agli stessi tipi di contenuti.
• Kekatsu DS: Supporto per Nintendo DS, GBA e altre piattaforme compatibili con metadata box art.

Metadata ScummVM

I metadata dei giochi ScummVM presenti nella cartella scummvm ora possono essere recuperati esclusivamente da IGDB, utilizzando una ricerca con parola chiave.

Matching hash Screenscraper

Il sistema di scansione cercherà di abbinare i giochi al database hash di Screenscraper, utilizzando gli hash pre-calcolati del file ROM principale. Se non viene trovato alcun match, il sistema ricorrerà alla logica di matching tramite nome file.

Modifiche minori

• [ROMM-2546] Le console ora possono essere ordinate per generazione, migliorando la gestione delle librerie by @gantoine in #2571
• [ROMM-2531] È stata aggiunta la possibilità di eseguire la scansione dei giochi anche senza fornitori di metadata by @gantoine in #2573
• [ROMM-2491] Aggiunto un pulsante shuffle nella barra di navigazione per mescolare rapidamente i giochi by @gantoine in #2574
• [ROMM-2289] Le regole dei filtri delle smart collection vengono ora visualizzate nella sidebar, rendendo più chiara la gestione delle collezioni by @gantoine in #2584
• [ROMM-2159] L’ordine di visualizzazione dei giochi viene ricordato al ricaricamento della pagina, evitando di doverlo impostare nuovamente by @gantoine in #2585
• [ROMM-2147] È stata chiarita la terminologia relativa ai tipi di scansione, per evitare ambiguità nell’uso delle funzioni by @gantoine in #2586

Nuove variabili ambiente

• SCAN_WORKERS: Numero di processi paralleli per la scansione.
• TASK_RESULT_TTL: Durata di conservazione dei risultati dei task in Valkey (secondi).
• SEVEN_ZIP_TIMEOUT: Timeout operazioni 7-Zip (secondi).

Correzioni

• [ROMM-2555] Validata la data di rilascio per i feed Tinfoil, garantendo coerenza nei metadata by @gantoine in #2557
• [ROMM-2554] Rimosso il riferimento a HTLB dalla ricerca manuale, semplificando le operazioni di ricerca by @gantoine in #2558
• [ROMM-2551] Corretto il messaggio di errore durante l’eliminazione di una ROM, migliorando la chiarezza per l’utente by @gantoine in #2559
• [ROMM-2552] Gli hash delle ROM ora includono solo i file principali di primo livello, evitando conflitti con file annidati by @gantoine in #2567
• [ROMM-2548] Migliorata la leggibilità del testo dell’avviso di nuova versione by @gantoine in #2568
• [ROMM-2547] Implementato lo scraping di Flashpoint basato sul tag flashpoint-XXX by @gantoine in #2569
• [ROMM-2338] Uniformata la gestione dei job in sospeso nel watcher, rendendo più coerente il monitoraggio delle attività by @gantoine in #2582
• [ROMM-2146] Abilitata l’apertura delle righe in una nuova scheda tramite click destro by @gantoine in #2587
• [HOTFIX] Corretto il recupero di salvataggi e stati per ROM o piattaforme by @gantoine in #2594
• Corretto errore di tipo quando il role claim è nullo by @Tarow in #2570
• Separati i controlli per verificare se config.yml è leggibile o scrivibile by @gantoine in #2588
• Correzioni per la scansione multi-threaded by @gantoine in #2583
• Mantenuto il parametro next durante il reindirizzamento alla pagina di login by @gantoine in #2611
• Migliorate le prestazioni della pagina di scansione per liste di giochi molto grandi by @gantoine in #2610
• Corretto il problema di hash per le ROM multi-file durante la scansione by @gantoine in #2618

Dietro le quinte

• [ROMM-2414] Rifattorizzato il caricamento dei dati in modalità console, migliorando l’efficienza e la manutenzione del codice by @gantoine in #2581
• Esplicitata la collezione dei preferiti nel modello, rendendo più chiara la gestione dei giochi contrassegnati come preferiti by @gantoine in #2564
• Aggiornate le applicazioni della community nel file README, garantendo informazioni più accurate e aggiornate by @gantoine in #2575
• Aggiornati i tag delle immagini base nel Dockerfile, assicurando compatibilità e stabilità del container by @gantoine in #2577
• Aggiornata la versione di Vite da 6.3.6 a 6.4.1 nel frontend, per miglioramenti delle performance e correzioni di bug by @dependabot[bot] in #2580

Modifiche alle API

• L’endpoint /config distingue ora tra CONFIG_FILE_MOUNTED e CONFIG_FILE_WRITABLE, migliorando la gestione dei file di configurazione.
• Il filtro dei preferiti per le ROM è stato rinominato da favourite a favorite.
• MetadataSource.LB è stato rinominato in MetadataSource.LAUNCHBOX.
• Nuovi campi aggiunti: CollectionSchema.is_favorite, RomSchema.gamelist_id, TaskInfo.type.
• Campi rimossi: SearchRomSchema.hltb_id e SearchRomSchema.hltb_url_cover.

Download: Source code RomM v4.4.0

Fonte: github.com