A beautiful, powerful, self-hosted rom manager and player. https://romm.app
Find a file
Georges-Antoine Assi f1fb0c726e
Disable fastapi_test
2025-12-07 10:40:07 -05:00
.devcontainer bump trunk and disable oxipng 2025-09-03 19:33:14 -04:00
.github Implement feature X to enhance user experience and optimize performance 2025-12-04 12:30:05 +00:00
.trunk tab separate kekatsu feed 2025-11-12 23:00:17 -05:00
.vscode fix issues from code review 2025-08-07 09:34:43 -04:00
backend Disable fastapi_test 2025-12-07 10:40:07 -05:00
docker Bump dockerfile baselayer image tags 2025-10-20 10:56:42 -04:00
examples Merge pull request #2700 from tvdu29/feature/metadata-locale-selection 2025-11-26 11:40:56 -05:00
frontend Move merged_screenshots and merged_ra_metadata to simple RomSchema 2025-12-02 10:32:17 -05: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 move env var in template 2025-10-26 21:10:27 -04:00
LICENSE switch to agpl license 2024-02-11 16:41:36 +01:00
pyproject.toml add tests for middlewares 2025-11-17 23:40:00 -05:00
README.md add selfshst badge to readme 2025-11-21 23:37:09 -05:00
SECURITY.md fixed everything from trunk 2024-07-09 13:43:14 +02:00
uv.lock add tests for middlewares 2025-11-17 23:40:00 -05:00

romm logo
romm logotype

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


license-badge-img release-badge-img docker-pulls-badge-img

discord-badge-img docs-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

Desktop

Handhelds

  • Mortar: Download client for NextUI by @UncleJunVIP
  • DeckRommSync: SteamOS downloader and syncer by @PeriBluGaming

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.

Project 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