ROMM Files

Highlights

UI overhaul

A ground-up redesign of the UI, with a new design system, fresh visual language, and a universal input model that feels at home with mouse, touch, keyboard and gamepad alike. With a stronger emphasis on performance, responsiveness, ease-of-use and accessibility, the new UI should be a joy on any device. [#3436]

Shared savestates

Share your game saves and savestates with other users; useful for speedrunning, special unlocks, new game +, or just showing off your progress. [#3569]

Interactive 3D boxart

Boxart go weeeeeeeeeeeeeeeeeeeeeeeeeeeee! [#3580]

CRT mode

Take me back to the 90s with a CRT shader that simulates the look of those old displays we love dearly. [#3552]

Server-side ROM patching

We've unlocked the full power of ROM patching by moving it to the server. Simply apply patches to your ROMs, now with the option to use stored or uploaded patch files. [#3225]

QR code pairing

Quickly pair your PC, TV or handheld device with your server by scanning a QR code (currently available on Argosy Launcher and Playnite). [#3308]

Real-time logs

Tired of SSHing into your server to tail the logs when something breaks? Now you can view the backend logs in real-time directly from the web UI. [#3557]

Controller debug view

Test your controller inputs and mappings in real-time with a new debug view. [#3581]

Changelog preview

A quick peak at the changes in the current version, with links to the full changelog. [#3560]

Granular permission system

Tweak access to your library with per-user and per-group permissions, with one configurable default group for new users. Tri-state grant/revoke on top of the group, and per-entity overrides, allow for fine-grained control over who can see what. [#3605]

Music player

Music files stored within a ROMs' soundtrack folder can now be played directly from details page (#3610), and queried directly from the API (#3640). This opens the door to future features like background music playback and soundtrack playlists.

Minor changes

• Add ES-DE <sortname> import and edit support for ROM ordering by @gantoine in https://github.com/rommapp/romm/pull/3460
• fix(ra): hash PSP compressed-ISO containers natively (#3600) by @gantoine in https://github.com/rommapp/romm/pull/3609
• feat(roms): filter games by matched metadata provider by @Spinnich in https://github.com/rommapp/romm/pull/3615
• feat(roms): filter games by custom tags by @Spinnich in https://github.com/rommapp/romm/pull/3629
• Add ROM revision field to game details overview by @gantoine in https://github.com/rommapp/romm/pull/3631
• Add Artwork subtab to Media tab with scraped art gallery by @gantoine in https://github.com/rommapp/romm/pull/3634 and https://github.com/rommapp/romm/pull/3700
• Add filters for has save/state by @gantoine in https://github.com/rommapp/romm/pull/3642
• Support markdown manuals and enforce allowed file types by @gantoine in https://github.com/rommapp/romm/pull/3683
• feat(player): remember emulator core per-game by @gantoine in https://github.com/rommapp/romm/pull/3701
• feat: Add debug overlay by @zurdi15 in https://github.com/rommapp/romm/pull/3554

Fixes

• fix: Refresh platforms on scan by @zurdi15 in https://github.com/rommapp/romm/pull/3555
• Handle missing ROM files during delete-from-filesystem requests by @zurdi15 in https://github.com/rommapp/romm/pull/3562
• fix: guard SiblingBadge against missing sibling_roms (scan crash with Group ROMs) by @androosio in https://github.com/rommapp/romm/pull/3568
• Permission fix for exported game lists and Pegasus platform slugs mapping by @ametis70 in https://github.com/rommapp/romm/pull/3587
• fix(platform): accept embedded custom_name body on platform update by @gantoine in https://github.com/rommapp/romm/pull/3597
• fix(webp): backfill cover conversion on startup when enabled by @gantoine in https://github.com/rommapp/romm/pull/3602
• fix(scan): prevent duplicate ROM entries from racing scans by @gantoine in https://github.com/rommapp/romm/pull/3606
• fix(scan): make scan tracker totals reflect platforms actually scanned by @gantoine in https://github.com/rommapp/romm/pull/3607
• Fix state/save injection timing and corruption in EmulatorJS by @gantoine in https://github.com/rommapp/romm/pull/3624
• fix(scan): Normalize Sony serial codes to uppercase before cache lookup by @gantoine in https://github.com/rommapp/romm/pull/3622
• Fix ROM name handling in UNMATCHED scans to replace placeholders by @gantoine in https://github.com/rommapp/romm/pull/3623
• fix(backend): load platform_id on siblings to avoid DetachedInstanceError by @gantoine in https://github.com/rommapp/romm/pull/3635
• Fix ROM upload temp directory to use RESOURCES_BASE_PATH by @gantoine in https://github.com/rommapp/romm/pull/3632
• fix(roms): namespace filter-values cache by schema version by @Spinnich in https://github.com/rommapp/romm/pull/3638
• fix(retroachievements): match MSX2 against RetroAchievements (#3644) by @Spinnich in https://github.com/rommapp/romm/pull/3645
• fix(retroachievements): match Famicom Disk System (FDS) against RetroAchievements by @Spinnich in https://github.com/rommapp/romm/pull/3647
• fix(retroachievements): match SuperGrafx against RetroAchievements by @Spinnich in https://github.com/rommapp/romm/pull/3652
• Fix typo in core mapping from 'zsx' to 'zxs' by @sildur in https://github.com/rommapp/romm/pull/3656
• Refine filename version-tag parsing to avoid swallowing generic v* tags by @gantoine in https://github.com/rommapp/romm/pull/3658
• fix: make 1.8 migration re-entrant so fresh installs stop crash-looping on MariaDB by @mvanhorn in https://github.com/rommapp/romm/pull/3669
• fix(retroachievements): hash GameCube and Wii RVZ/WIA images natively by @Spinnich in https://github.com/rommapp/romm/pull/3657
• fix(collections): download whole collections as a single zip by @Spinnich in https://github.com/rommapp/romm/pull/3661
• fix: display selected firmware in player by @chiyi-creator in https://github.com/rommapp/romm/pull/3673
• fix: stop mapping Public Domain ROMs to Poland by @chiyi-creator in https://github.com/rommapp/romm/pull/3671
• fix: allow NAT64-wrapped public IPs through SSRF filter by @gantoine in https://github.com/rommapp/romm/pull/3675
• Use parsed filename for unmatched ROM titles instead of raw filename by @gantoine in https://github.com/rommapp/romm/pull/3681
• fix(scan): fall back to other providers when ScreenScraper quota is exhausted by @gantoine in https://github.com/rommapp/romm/pull/3686
• fix(launchbox): import local media when matching via update_rom by @gantoine in https://github.com/rommapp/romm/pull/3687
• feat: default UI language to browser language when available by @gantoine in https://github.com/rommapp/romm/pull/3690
• fix(platforms): stop platform variants from renaming the parent platform by @gantoine in https://github.com/rommapp/romm/pull/3693
• fix: generate virtual collections from all metadata sources by @gantoine in https://github.com/rommapp/romm/pull/3694
• fix(sockets): require TASKS_RUN scope for scan and scan:stop by @gantoine in https://github.com/rommapp/romm/pull/3698
• fix(roms): enforce parent ROM visibility on direct file endpoints by @gantoine in https://github.com/rommapp/romm/pull/3703
• fix(backend): correct M4A embedded cover extraction and validation by @VoidHandler in https://github.com/rommapp/romm/pull/3705
• fix(launchbox): match remote cover art region to ROM region by @gantoine in https://github.com/rommapp/romm/pull/3709
• fix(backend): serve PDF/Markdown manuals inline so the viewer can render them by @gantoine in https://github.com/rommapp/romm/pull/3714
• fix: surface config.yml parse errors instead of silently using defaults by @gantoine in https://github.com/rommapp/romm/pull/3713
• fix(frontend): restore manual display and extract ManualSubtab by @gantoine in https://github.com/rommapp/romm/pull/3717
• Fixed the translation of "player-count" by @wolfg1969 in https://github.com/rommapp/romm/pull/3719
• fix(scan): make Hasheous and SteamGridDB scan lookups fault-tolerant in the metadata handlers by @TowyTowy in https://github.com/rommapp/romm/pull/3716
• fix(backend): discard ScreenScraper chroma-key green placeholder art by @gantoine in https://github.com/rommapp/romm/pull/3724
• fix(frontend): restore manual display and extract ManualSubtab by @gantoine in https://github.com/rommapp/romm/pull/3717
• Fixed the translation of "player-count" by @wolfg1969 in https://github.com/rommapp/romm/pull/3719
• fix(scan): make Hasheous and SteamGridDB scan lookups fault-tolerant in the metadata handlers by @TowyTowy in https://github.com/rommapp/romm/pull/3716
• fix(backend): discard ScreenScraper chroma-key green placeholder art by @gantoine in https://github.com/rommapp/romm/pull/3724
• fix(ui): remove cover-art attribution link on details pages by @gantoine in https://github.com/rommapp/romm/pull/3737 fix(scan): strip leading dot from dot-separated version tags by @TowyTowy in https://github.com/rommapp/romm/pull/3751

Other changes

• fix(search): full-text indexes+caching by @bonofiglio in https://github.com/rommapp/romm/pull/3540
• Integrate Hypothesis property-based testing for the backend by @gantoine in https://github.com/rommapp/romm/pull/3403
• feat: backend connection status notice + offline-aware boot by @zurdi15 in https://github.com/rommapp/romm/pull/3550
• Run backend tests in parallel with pytest-xdist by @gantoine in https://github.com/rommapp/romm/pull/3559
• feat(auth): add OIDC_ALLOW_REGISTRATION toggle to gate OIDC auto-registration by @Spinnich in https://github.com/rommapp/romm/pull/3577
• docs: split frontend constitution into focused agent skills, make CLAUDE.md holistic by @gantoine in https://github.com/rommapp/romm/pull/3581
• Exclude served resources from Vite dev watcher by @gantoine in https://github.com/rommapp/romm/pull/3586
• Add test data generator script by @gantoine in https://github.com/rommapp/romm/pull/3585
• Test Build GitHub Action improvements by @ametis70 in https://github.com/rommapp/romm/pull/3588
• fix(deps): bump dependencies to patch reported vulnerabilities by @gantoine in https://github.com/rommapp/romm/pull/3592
• Turkish language support tr_TR by @y1lm-z in https://github.com/rommapp/romm/pull/3593
• perf(roms): speed up the gallery/search list endpoint on large libraries by @gantoine in https://github.com/rommapp/romm/pull/3595
• Stop spamming PRs with coverage reports by @gantoine in https://github.com/rommapp/romm/pull/3625
• Squash legacy migrations by @gantoine in https://github.com/rommapp/romm/pull/3670
• docs(claude): add PR linking and template conventions by @gantoine in https://github.com/rommapp/romm/pull/3682
• i18n: rename "Duplicates" filter to "Versions" in the UI by @gantoine in https://github.com/rommapp/romm/pull/3688
• test: add axe accessibility gate + keyboard nav tests to Storybook by @gantoine in https://github.com/rommapp/romm/pull/3691
• docs(sync): clarify slot pairing behavior in negotiate OpenAPI spec by @gantoine in https://github.com/rommapp/romm/pull/3699
• feat(playmatch): move integration to API v2 by @DevYukine in https://github.com/rommapp/romm/pull/3689
• ci: fail PRs that modify the frozen frontend v1 UI by @gantoine in https://github.com/rommapp/romm/pull/3723
• Hotfix upload buttons in media tabs by @gantoine in https://github.com/rommapp/romm/pull/3732
• ci: fail PRs that modify the frozen frontend v1 UI by @gantoine in https://github.com/rommapp/romm/pull/3723
• Add Freegosy to community tab in README by @abduznik in https://github.com/rommapp/romm/pull/3729
• Update README featured projects by @QuaiGoner in https://github.com/rommapp/romm/pull/3738
• feat: inject ScreenScraper dev credentials at build time by @gantoine in https://github.com/rommapp/romm/pull/3740
• build(deps): bump python-engineio from 4.12.2 to 4.13.2 by @dependabot[bot] in https://github.com/rommapp/romm/pull/3626
• build(deps): bump joserfc from 1.6.3 to 1.6.7 by @dependabot[bot] in https://github.com/rommapp/romm/pull/3627
• build(deps): bump python-socketio from 5.14.0 to 5.16.2 by @dependabot[bot] in https://github.com/rommapp/romm/pull/3628
• chore(deps): bump joserfc from 1.6.7 to 1.6.8 by @dependabot[bot] in https://github.com/rommapp/romm/pull/3672

New Contributors

• @bonofiglio made their first contribution in https://github.com/rommapp/romm/pull/3540
• @androosio made their first contribution in https://github.com/rommapp/romm/pull/3568
• @ametis70 made their first contribution in https://github.com/rommapp/romm/pull/3587
• @y1lm-z made their first contribution in https://github.com/rommapp/romm/pull/3593
• @sildur made their first contribution in https://github.com/rommapp/romm/pull/3656
• @mvanhorn made their first contribution in https://github.com/rommapp/romm/pull/3669
• @chiyi-creator made their first contribution in https://github.com/rommapp/romm/pull/3673
• @VoidHandler made their first contribution in https://github.com/rommapp/romm/pull/3705
• @wolfg1969 made their first contribution in https://github.com/rommapp/romm/pull/3719
• @TowyTowy made their first contribution in https://github.com/rommapp/romm/pull/3716

Full Changelog: https://github.com/rommapp/romm/compare/4.9.2...5.0.0