ROMarr

ROMarr is a self-hosted application that automates game ROM acquisition for your library.

  • Downloaders
  • Game Servers
  • Media Applications
ROMarr is a self-hosted application that automates game ROM acquisition for your library. Request a title and it searches your torrent indexers through Prowlarr, passes the best release to your download client, and files the ROM into your game library. If you already run Radarr for films and Sonarr for TV, ROMarr fills that same role for games. It supports RomM, Gaseous, and Retrom as library back-ends, plus a folder mode that writes a plain platform-organised directory tree for front-ends such as EmulationStation, Batocera, RetroPie, ES-DE, EmuDeck, Pegasus, Lakka, muOS, and LaunchBox.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

77/100 Good

Maintained
100last commit 1 day ago
Popular
52406 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
95no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
406
Open issues
1
Last commit
2026-11-20
Latest release
v1.11.5
License
MIT
Activity
rising

Checked yesterday - source: GitHub (BlizzHacker/romarr)

Resources & Compatibility

Requirements not published yet.

Checked 49 days ago - source: Docker Hub image tags and published docs

First-install notes

  • First-Start Environment Variables ROMarr reads its environment variables only once, on first start, and copies them into its internal settings. After that, the saved settings take precedence and editing the container variables has no effect. This is intentional so you can adjust settings on the Settings page without touching the compose file or template. source
  • Standalone operation ROMarr runs on its own and requires no parent application; optional extended source support is available via ROM Hub. source
  • Standalone operation and plugins ROMarr works standalone; optional source plugins are added via ROM Hub and imported through ROMarr’s Hub tab. source
  • Unraid Install Use the official Unraid app listing, which installs the ghcr.io/blizzhacker/romarr container image. source
  • Start with one system and one game The README onboarding guide recommends starting with one gaming system and one game before adding ROMs or search sources. source

Fetched yesterday - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Do I need Prowlarr to use ROMarr with torrents?

ROMarr can search indexers through Prowlarr or directly. The chosen release is then passed to the matching download client or watched folder.

Which download clients can ROMarr use for torrents and usenet?

For torrents, it supports 13 daemons, 8 debrid services, or a watched folder. For usenet, it supports SABnzbd, NZBGet, NZBVortex, or a watched folder.

Can ROMarr file ROMs for front-ends that use a plain folder structure?

Yes, a folder mode writes a plain platform-organised directory tree. It is aimed at front-ends such as EmulationStation, Batocera, RetroPie, ES-DE, EmuDeck, Pegasus, Lakka, muOS, and LaunchBox.

If I change environment variables in my compose file after first start, will ROMarr pick them up?

No, ROMarr reads environment variables only once on first start and copies them into its internal settings. Saved settings take precedence, so you should adjust settings on the Settings page instead.

How do I add a new ROM source to ROMarr?

ROM Hub is where sources are written, run, and sandboxed as plugins. ROMarr picks them up from its Hub tab, so adding a source means writing a plugin there rather than patching ROMarr.

Answers sourced from github.com, github.com

Community

Collected 48 days ago - public community threads