romm logo

romm

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

Website GitHub

What is it?

What it is

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

Why it exists

To allow users to scan, enrich, browse, and play their game collections with metadata from multiple sources, custom artwork, achievements, and browser-based emulation, supporting many platforms and naming schemes.

Who should use it

Retro gaming enthusiasts with personal ROM collections who want a self-hosted, feature-rich manager to scan, enrich metadata, browse, and play games via a web interface, as well as users who wish to share their library with friends or integrate with other frontends like Playnite or Android apps.

Who should avoid it

Users who do not own ROMs, prefer all-in-one solutions without self-hosting, are uncomfortable with basic server setup (Docker, reverse proxy), or only need a simple launcher for official store games.

How it works

A quick walkthrough in plain English

How romm works

Step 1 of 3

You interact with it

Open romm, send a request, or connect it to your stack.

Features

Scan and enhance game library with metadata from IGDB, Screenscraper, and MobyGames
Fetch custom artwork from SteamGridDB
Display achievements from Retroachievements
Metadata available for 400+ platforms
Play games directly from the browser using EmulatorJS and RuffleRS
Share library with friends with limited access and permissions
Official apps for Playnite, Android, and CFWs
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

Advantages

  • Self-hosted gives full control over data
  • Beautiful, responsive web interface
  • Extensive platform support (400+)
  • Rich metadata and artwork integration
  • Browser-based gameplay eliminates need for separate emulator install
  • Community-driven official apps for various clients
  • Open source under AGPL-3.0 encourages transparency
  • Flexible tagging and filtering system
  • Supports complex game collections (multi-disk, DLC, mods)
  • Easy sharing with permission controls

Disadvantages

  • AGPL-3.0 license may restrict use in proprietary environments
  • Requires self-hosting setup and maintenance
  • Relies on external metadata APIs which may have rate limits or downtime
  • Primarily focused on ROM management, may not suit non-ROM game libraries
  • Initial library scanning can be time-consuming for large collections
  • Advanced features may require familiarity with Docker or command line
  • Limited official support for certain niche platforms

Installation

FAQ

What is romm?

romm is an open-source project licensed under AGPL-3.0.

What language is romm built with?

Primary language: Python.

Is it free to use?

Yes. Licensed under AGPL-3.0. Check the license for commercial use.

Loading documentation…
View on GitHub

Featured in Videos

YouTube tutorials and walkthroughs for romm

Alternatives

Similar projects ranked by category, topics, and text overlap.

Compare
romm | MushyBook