# ROMarr

ROMarr is a self-hosted application that automates game ROM acquisition for your library. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6799/romarr

## Description

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.

## Health score

77/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 1 day ago)
- Popular: 52 (406 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 95 (no serious findings, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/romarr-04jslct0riva81?q=ROMarr
- GitHub: https://github.com/BlizzHacker/romarr
- Official website: https://yarrit.com

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/6799/romarr), the self-hosted and open-source app directory.
