rommapp /romm
A beautiful, powerful, self-hosted ROM manager and player.
★ 14,384⑂ 822👁 54⑃ 3,181● 2,343▤ 216
+8
日增长
+167
周增长
14,384
stars
822
forks
54
watchers
3,181
prs
2,343
issues
216
releases
README
A beautiful, powerful, self-hosted ROM manager and player.
Overview
Scan, enrich, browse and play your ROM collection from one beautiful & free self-hosted app. Metadata from 10+ providers, save sync across your devices, and support for over 400 platforms. RomM is a must-have for anyone who plays on emulators.
Features
- Play in your browser with [EmulatorJS][docs-emulatorjs] and [RuffleRS][docs-rufflers], no setup required
- Keep [saves and states][docs-saves] in sync across your devices, with conflict resolution
- Scan and enrich your library with metadata from [IGDB][igdb-api], [Screenscraper][screenscraper-api], [LaunchBox][launchbox-api] and [MobyGames][mobygames-api]
- Fetch custom artwork from [SteamGridDB][steamgriddb-api] and track your achievements from [Retroachievements][retroachievements-api]
- Metadata available for [400+ platforms][docs-supported-platforms], plus multi-disk games, DLCs, mods, hacks and manuals
- Apply romhacks and translations on the fly with the built-in [ROM patcher][docs-rom-patcher]
- Share your library with granular [per-user permissions][docs-users-and-roles] and [OIDC single sign-on][docs-oidc]
- Official apps for [Playnite][playnite-app], [Android][argosy-launcher] and [CFWs][grout]
- Free forever: AGPL-3.0, no tracking, no paid features, and total control of your data
Installation
The easiest way to start is with the [Quick Start Guide][docs-quick-start-guide] in the docs. If you're having trouble with setup, please review the page for [troubleshooting steps][docs-troubleshooting].
Prefer a hosted deploy over wiring up the stack yourself?
Starting at $6.49/mo · Setup guide
Starting at $2.30/mo · Setup guide
Deployment and infrastructure support for these installs is handled by Hostinger and CoreHost. Prices are indicative and may not reflect current offerings. Both send a share of the revenue back to us, which helps fund the project.
Official apps
Playnite plugin
Effortlessly integrate your retro game collection into Playnite, the open-source game library manager that provides a unified interface for all of your games on PC.
Windows Desktop QR pairing
by @gantoine
Argosy
Sync your library, download games on demand and track your achievements, from a gamepad-first interface designed for Anbernic, Retroid Pocket, Odin, and similar devices.
Android Handhelds QR pairing Save sync
by @tmgast
Grout
A lightweight client for your favorite handheld custom firmwares. Download games, box art and BIOS files wirelessly, and sync your saves automatically as you play.
Linux Handhelds Save sync
by @BrandonKowalski
Supports Allium, Batocera, Knulli, MinUI, muOS, NextUI, Onion, ROCKNIX, Spruce and TrimUI.
Community
Here are some cool projects maintained by members of our community. Please note that our team does not regularly rTop issues
#3095[Task] Strip OS special characters and enable fuzzy matching for metadata11 comments · 2026-03-09#3619[Feature] Set As... DLC/Update10 comments · 2026-06-27#2743[Feature] Version Descriptions9 comments · 2025-12-01#5576[Bug] Webstation stream drops to ~20 fps inside RomM's player, same session runs at 60 fps opened directly8 comments · 2026-11-12#5518[Task] Need to do something about memory usage7 comments · 2026-11-08#2482[Feature] Offline PSP metadata and artwork extraction7 comments · 2025-09-24#5587[Feature] Option to group games by franchise or collection in the library6 comments · 2026-11-13#5206[Task] Performant Search6 comments · 2026-10-09
Discussions
#4871Authorization: romm-ios-app is a permitted third-party RomM client1 comments · 2026-09-28#2199RFC-0001: Save Synchronization System7 comments · 2025-08-04#1666February Community Update0 comments · 2025-02-25#1665Third Party App, Device and OS Integrations11 comments · 2025-02-25#1367December community update0 comments · 2024-12-18#1143Supporting the project0 comments · 2024-08-31#740Version 3 Migration - Unraid1 comments · 2024-03-20#739Stop Scan2 comments · 2024-03-20
Latest release
5.4.1 5.4.1 2026-10-22[!CAUTION] This release includes mitigations for the recent eMudhra CA compromise as well as general dependency upgrades. While we don't believe RomM instances are vulnerable, we recommend upgrading as soon as possible. What's Changed docs(readme): move corporate sponsors above friends by @gantoine in https://github.com/rommapp/romm/pull/5219 chore(deps-dev): bump handlebars from 4.7.9 to 4.7.10 in /frontend by @dependabot[bot] in https://github.com/rommapp/romm/pull/5221 fix(deps): bump certifi to 2026.10.19 to distrust compromised eMudhra intermediates by @gantoine in https://git