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

_{Deployment and infrastructure support for this install is handled by Hostinger. Prices are indicative and may not reflect current offerings. Signups through the link above 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 review their source code.

Mobile and TV

[R-Shop][r-shop]: Controller-first game manager for Android handhelds and TVs by @AverageConsumer
[romm-ios-app][romm-ios-app]: Native iOS app by @ilyas-hallak
[RomMMobile][rommmobile]: Android app that downloads games into your existing frontend's folders by @pippopapera
[RomMulus][rommulus]: Android TV app with built-in emulator cores and save sync by @DEV-DUFORD

Desktop

[Freegosy][freegosy]: Cross-platform game manager with save sync by @abduznik
[RetroVault][retrovault]: Native macOS library and player by @kennethreitz
[romm-client][romm-client]: Desktop client by @chaun14
[RomMate][rommate]: Desktop app for browsing your collection by @brenoprata10

Handhelds and Steam Deck

[Gameflow Deck][gameflow-deck]: Controller-first frontend for handhelds by @simeonradivoev
[KONSORU][konsoru]: Home screen launcher for the AYN Thor with a themed UI per console by @FabianZettl
[RomMix][rommix]: Big Picture-style frontend for Linux and Steam Deck by @leclercb
[Tender][romm-tender]: Decky Loader plugin with library and save sync for Steam Deck by @danielcopper
[Vita RomM][vita-romm]: PS Vita homebrew client for browsing and downloading games by @denkacn

Sync

[RetroArch Sync][romm-retroarch-sync]: Sync RetroArch library with RomM by @Covin90
[Syncthing sync][syncthing-sync]: Small tool to push a Syncthing library to RomM by @amn-96

Integrations

[GGRequestz][ggrequestz]: Game discovery and request tool by @XTREEMMAK
[romm-comm][romm-comm-discord-bot]: Discord bot by @idio-sync

Support the project

Consider supporting this project on Open Collective. Funds cover hosting, development, and maintenance, and we pass some along to community projects to nurture a healthy ecosystem of apps.

Corporate Sponsors

These companies support us by providing their tools for free:

Our Friends

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

Lutris: Open gaming platform for Linux
Cocoon: Controller-first Android frontend for retro handhelds
muOS: Custom firmware for Anbernic and other handhelds
RetroDECK: Retro gaming on SteamOS and Linux
Steam ROM Manager: An app for managing ROMs in Steam
Hasheous: Hash lookup service that maps ROMs to game metadata
Gaseous: Another ROM manager with web-based emulator
Playmatch: Microservice for matching ROM hashes to games
EmulatorJS: An embeddable, browser-based emulator
PortMaster: Native game ports for Linux handhelds
MelonLoader: Universal mod loader for Unity games
NextUI: MinUI-based custom firmware for TrimUI handhelds
RetroAchievements: Achievements for retro games

[docs-quick-start-guide]: https://docs.romm.app/latest/Getting-Started/Quick-Start-Guide/ [docs-supported-platforms]: https://docs.romm.app/latest/Platforms-and-Players/Supported-Platforms/ [docs-emulatorjs]: https://docs.romm.app/latest/Platforms-and-Players/EmulatorJS-Player/ [docs-rufflers]: https://docs.romm.app/latest/Platforms-and-Players/RuffleRS-Player/ [docs-troubleshooting]: https://docs.romm.app/latest/Troubleshooting/Scanning-Issues/ [docs-saves]: https://docs.romm.app/latest/using/saves-and-states/ [docs-rom-patcher]: https://docs.romm.app/latest/using/rom-patcher/ [docs-users-and-roles]: https://docs.romm.app/latest/administration/users-and-roles/ [docs-oidc]: https://docs.romm.app/latest/administration/oidc/

[igdb-api]: https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#igdb [screenscraper-api]: https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#screenscraper [mobygames-api]: https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#mobygames [launchbox-api]: https://docs.romm.app/latest/getting-started/metadata-providers/#launchbox [steamgriddb-api]: https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#steamgriddb [retroachievements-api]: https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#retroachievements [romm-comm-discord-bot]: https://github.com/idio-sync/romm-comm [romm-tender]: https://github.com/danielcopper/romm-tender [playnite-app]: https://github.com/rommapp/playnite-plugin [ggrequestz]: https://github.com/XTREEMMAK/ggrequestz [syncthing-sync]: https://github.com/amn-96/romm_syncthing_sync [romm-client]: https://github.com/chaun14/romm-client [romm-retroarch-sync]: https://github.com/Covin90/romm-retroarch-sync [rommate]: https://github.com/brenoprata10/rommate [freegosy]: https://github.com/abduznik/freegosy [rommulus]: https://github.com/DEV-DUFORD/rommulus [retrovault]: https://github.com/kennethreitz/RetroVault [gameflow-deck]: https://github.com/simeonradivoev/gameflow-deck [rommix]: https://github.com/leclercb/rommix [vita-romm]: https://github.com/denkacn/vita-romm [r-shop]: https://github.com/AverageConsumer/R-Shop [rommmobile]: https://github.com/pippopapera/RomMMobile [konsoru]: https://github.com/FabianZettl/konsoru-launcher-releases [grout]: https://github.com/rommapp/grout [romm-ios-app]: https://github.com/ilyas-hallak/romm-ios-app [argosy-launcher]: https://github.com/rommapp/argosy-launcher

rommapp/romm: A beautiful, powerful, self-hosted ROM manager and player.