Download Latest Version 4.6.1 source code.tar.gz (19.0 MB)
Email in envelope

Get an email when there's a new version of ROMM

Home / 4.4.0
Name Modified Size InfoDownloads / Week
Parent folder
4.4.0 source code.tar.gz 2025-11-09 26.3 MB
0
4.4.0 source code.zip 2025-11-09 120.6 MB
0
README.md 2025-11-09 12.0 kB
0
Totals: 3 Items   146.9 MB 0

Highlights

[!WARNING] * The Tinfoil feed endpoint has been updated from /tinfoil/feed to /feeds/tinfoil, update your Tinfoil config accordingly. * A manual Scheduled LaunchBox metadata update must be run once before Launchbox can be used as a metadata source.

Alternative boxart

Spice up your collection with 3D, physical, and mixed media boxart, courtesy of Screenscraper! Start by configuring which media assets to download in your config.yml file:

:::yaml
scan:
  media:
    - box2d
    - box3d
    - physical
    - miximage
    - screenshot
    - manual
    - bezel

Available media types: - box2d - Normal cover art (always enabled) - box3d - 3D box art - miximage - Mixed image of multiple media - physical - Disc, cartridge, etc. - screenshot - Screenshot (enabled by default) - title_screen - Title screen - marquee - Custom marquee - logo - Transparent logo - fanart - User uploaded artwork - bezel - Bezel displayed around the EmulatorJS window - manual - Manual in PDF format (enabled by default) - video - Gameplay video (warning: large file size)

Restart the container. Now on the scan page, select Screenscraper as the metadata source, Update metadata as the scan type, and click the Scan button. The media assets will be downloaded and stored alongside existing resources for covers and screenshots. Then under User Interface (/user-interface), change the Boxart style to 3D, Physical, or Mix Image as desired.

2D Box
Screenshot_2025-10-23_at_3 54 58_PM
3D Box
Screenshot_2025-10-23_at_3 55 07_PM
Physical
Screenshot_2025-10-23_at_3 55 16_PM
Mix Image
Screenshot_2025-10-23_at_3 55 25_PM

https://github.com/rommapp/romm/pull/2598

ES-DE gamelist.xml

EmulationStation, and it's modern successor ES-DE, use a custom XML format to store game metadata. RomM can parse this format and import the assets as cover art and screenshots. You'll need to store the gamelist.xml file and any related assets under the platform folder, and select ES-DE in the "Metadata sources" dropdown on the scan page:

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

Here's an example of the content in a typical gamelist.xml file, though the parser supports more fields not listed:

:::xml
<?xml version="1.0"?>
<gameList>
    <game>
        <path>./Advance Wars (J) (Rev 1).zip</path>
        <name>Advance Wars</name>
        <desc>The battle lines have been drawn, and an elite group of sly strategists is massing troops at your borders. You'll have to command ground, air and naval forces if you hope to survive the coming wars, and it won't be easy. With 114 maps to battle on and both the Single-Pak and Multi-Pak link modes, Advance Wars brings turn-based strategy to a depth never before seen on a handheld!</desc>
        <rating>0.8</rating>
        <releasedate>20020111T000000</releasedate>
        <developer>Intelligent Games</developer>
        <publisher>Nintendo</publisher>
        <genre>Strategy</genre>
        <players>1-4</players>
        <video>./videos/Advance Wars (J) (Rev 1).mp4</video>
        <box3d>./3dboxes/Advance Wars (J) (Rev 1).png</box3d>
        <backcover>./backcovers/Advance Wars (J) (Rev 1).png</backcover>
        <cover>./covers/Advance Wars (J) (Rev 1).png</cover>
        <fanart>./fanart/Advance Wars (J) (Rev 1).jpg</fanart>
        <manual>./manuals/Advance Wars (J) (Rev 1).pdf</manual>
        <marquee>./marquees/Advance Wars (J) (Rev 1).png</marquee>
        <miximage>./miximages/Advance Wars (J) (Rev 1).png</miximage>
        <physicalmedia>./physicalmedia/Advance Wars (J) (Rev 1).png</physicalmedia>
        <screenshot>./screenshots/Advance Wars (J) (Rev 1).png</screenshot>
        <title_screen>./titlescreens/Advance Wars (J) (Rev 1).png</title_screen>
        <thumbnail>./covers/Advance Wars (J) (Rev 1).png</thumbnail>
    </game>
</gameList>

https://github.com/rommapp/romm/pull/2563

Task status page

We've added a new section on the /administration page for monitoring background tasks. This section displays real-time task status, execution statistics for successful tasks, and error messages for failed tasks. [#2502]

Screenshot 2025-10-27 at 4 05 56 PM

Multi-threaded library scanning

Multiple games under the same platform can now be scanned in parallel, significantly reducing the time required to scan large libraries. Simply increase the SCAN_WORKERS environment variable to the number of games to scan in parallel. Note that parallel scanning is limited by the power of your CPU and the maximum permitted connections to selected metadata providers. [#2566]

Screenshot 2025-10-27 at 4 22 23 PM

Manually edit metadata

The game's edit window now allows you to directly edit metadata IDs and JSON values. Changing a metadata ID will prompt the server to refresh metadata from that specific source, using the new ID. The JSON values can also be edited directly, and will be saved as raw metadata; for example, you can update youtube_video_id to use gameplay videos instead of trailers. Note: an UPDATE or COMPLETE scan of a game will override any manual changes made to metadata IDs or JSON values. [#2578]

Screenshot 2025-10-27 at 4 29 06 PM

PS3/PSVita/PSP PKGi and Kekatsu DS feeds

Added support for PKGi and Kekatsu feed formats, enabling direct integration with popular game download tools:

  • PKGi PS3 (/feeds/pkgi/ps3/{content_type}): Supports games, DLC, demos, updates, patches, mods, translations, and prototypes
  • PKGi PSP (/feeds/pkgi/psp/{content_type}): Supporting the same content types
  • PKGi PS Vita (/feeds/pkgi/psvita/{content_type}): Supporting the same content types
  • Kekatsu DS (/feeds/kekatsu/{platform_slug}): Supporting Nintendo DS, GBA, and other compatible platforms with box art metadata

https://github.com/rommapp/romm/pull/2572

ScummVM metadata

Metadata for ScummVM games stored under a scummvm folder can now be fetched exclusively from IGDB, using a special keyword search. [#2576]

Screenshot 2025-10-27 at 4 27 46 PM

Screenscraper hash matching

The scanner will attempt to match games against Screenscraper's hash database, using the pre-calculated hashes for the largest, top-level ROM file. If no match is found, it will fall back to the existing file name matching logic. [#2616]

[#2616]

Minor changes

[!NOTE] New environment variables * SCAN_WORKERS: Number of parallel worker processes for scanning games * TASK_RESULT_TTL: How long to keep task results in Valkey (in seconds) * SEVEN_ZIP_TIMEOUT: imeout for 7-Zip operations (in seconds)

Fixes

Behind-the-scenes

[!NOTE] API changes: * The /config endpoint now distinguishes between CONFIG_FILE_MOUNTED and CONFIG_FILE_WRITABLE * The favourite filter for roms has been renamed to favorite * MetadataSource.LB was renamed to MetadataSource.LAUNCHBOX * New fields: CollectionSchema.is_favorite, RomSchema.gamelist_id, RomSchema.gamelist_id, TaskInfo.type * Removed fields: SearchRomSchema.hltb_id, SearchRomSchema.hltb_url_cover

New Contributors

Full Changelog: https://github.com/rommapp/romm/compare/4.3.2...4.4.0

Bonus

Here's a little treat for reading all of the release notes 🍬

https://github.com/user-attachments/assets/56f9aa0d-5cc9-4371-b0a1-b848312cfebc

Source: README.md, updated 2025-11-09