A beautiful, powerful, self-hosted rom manager and player. https://romm.app
Find a file
2025-12-24 01:36:14 +01:00
.devcontainer bump trunk and disable oxipng 2025-09-03 19:33:14 -04:00
.github fix pr template 2025-12-09 13:41:25 -05:00
.trunk update trunk linters 2025-12-09 21:33:09 -05:00
.vscode fix issues from code review 2025-08-07 09:34:43 -04:00
backend Merge pull request #2800 from victor-rds/feat-search-metadata-priority 2025-12-23 11:34:24 -05:00
docker add config entry to enable netplay 2025-12-08 22:58:48 -05:00
examples Add config options to disable batch bootup and auto unload in emujs 2025-12-21 10:50:27 -05:00
frontend fix: update button class to use translucent-light for better visibility 2025-12-24 00:36:02 +00:00
.gitattributes Mark cassettes as lingust generated 2023-08-01 00:26:02 -04:00
.gitignore include empty config tests 2025-07-24 23:45:18 -04:00
.python-version misc: Upgrade to Python 3.13 2025-07-03 23:37:00 -03:00
CODE_OF_CONDUCT.md start fixing mypy issues 2024-05-21 19:22:14 -04:00
CONTRIBUTING.md Add AI guideline to contributing.md 2025-08-22 16:15:45 -04:00
DEVELOPER_SETUP.md run trunk check 2025-09-21 13:24:34 -04:00
docker-compose.yml vite env vers need boolean checks 2025-09-19 17:23:32 -04:00
Dockerfile fix a bunch of shit 2025-08-09 11:16:12 -04:00
entrypoint.sh Make default ROMM_AUTH_SECRET_KEY consistent between workers 2025-08-15 12:46:46 -04:00
env.template [ROMM-2748] Add OIDC_USERNAME_ATTRIBUTE 2025-12-08 10:27:15 -05:00
LICENSE switch to agpl license 2024-02-11 16:41:36 +01:00
pyproject.toml bump joserfc to 1.3.5 2025-12-08 10:13:55 -05:00
README.md tweaks to readme style 2025-12-16 09:41:28 -05:00
SECURITY.md fixed everything from trunk 2024-07-09 13:43:14 +02:00
uv.lock bump urllib3 2025-12-15 18:15:55 -05:00

romm logo

A beautiful, powerful, self-hosted ROM manager and player.

discord-badge-img docs-badge-img license-badge-img release-badge-img docker-pulls-badge-img

Overview

RomM (ROM Manager) allows you to scan, enrich, browse and play your game collection with a clean and responsive interface. With support for multiple platforms, various naming schemes, and custom tags, RomM is a must-have for anyone who plays on emulators.

Features

  • Scan and enhance your game library with metadata from IGDB, Screenscraper and MobyGames
  • Fetch custom artwork from SteamGridDB
  • Display your achievements from Retroachievements
  • Metadata available for 400+ platforms
  • Play games directly from the browser using EmulatorJS and RuffleRS
  • Share your library with friends with limited access and permissions
  • Official apps for Playnite and muOS
  • Supports multi-disk games, DLCs, mods, hacks, patches, and manuals
  • Parse and filter by tags in filenames
  • View, upload, update, and delete games from any modern web browser

Preview

🖥 Desktop 📱 Mobile
desktop preview mobile preview

Installation

To start using RomM, check out the Quick Start Guide in the docs. If you are having issues with RomM, please review the page for troubleshooting steps.

Contributing

To contribute to RomM, please check Contribution Guide.

Community

Here are a few projects maintained by members of our community. Please note that the RomM team does not regularly review their source code.

Mobile

  • romm-mobile: Android (and soon iOS) app by @mattsays
  • romm-ios-app: Native iOS app by @ilyas-hallak
  • romm-android: Android app by @samwelnella
  • Argosy: Native client for installing and launching games by @tmgast

Desktop

Handhelds

  • Grout: Download client for muOS and NextUI by @UncleJunVIP
  • DeckRommSync: SteamOS downloader and syncer by @PeriBluGaming
  • SwitchRomM: Homebrew NRO for Switch by @Shalasere

Other

  • romm-comm: Discord bot by @idio-sync
  • GGRequestz: Game discovery and request tool by @XTREEMMAK

Join us on Discord, where you can ask questions, submit ideas, get help, showcase your collection, and discuss RomM with other users.

discord-invite-img

Technical Support

If you have any issues with RomM, please open an issue in this repository.

Financial Support

Consider supporting the development of this project on Open Collective. All funds will be used to cover the costs of hosting, development, and maintenance of RomM.

oc-donate-img

Our Friends

Here are a few projects that we think you might like:

  • EmulatorJS: An embeddable, browser-based emulator
  • RetroDECK: Retro gaming on SteamOS and Linux
  • ES-DE Frontend: Emulator frontend for Linux, macOS and Windows
  • Gaseous: Another ROM manager with web-based emulator
  • Retrom: A centralized game library/collection management service
  • Drop: Steam-like experience for DRM-free games
  • LanCommander: Digital game platform for PC games
  • Steam ROM Manager: An app for managing ROMs in Steam

hackernews badge   selfh.st badge   Aikido Security Audit Report