Skip to content

Getting Started

BlizzHacker edited this page Nov 17, 2026 · 1 revision

Getting Started

Open Settings → Setup Guide (/#setup). You can skip any step and come back later.

1. Choose where games go

Add a library under Settings → Libraries: a RomM server, a plain folder, or ROMarr's built-in library. ROMarr imports into it and, for RomM, asks it to rescan.

Import a ROM you already have

  1. Put one file in the downloads folder ROMarr can see.
  2. Open Manual Import and scan that folder.
  3. Check the detected platform and the verification result.
  4. Press Import.

Your original download is kept. ROMarr copies or hard-links into the library rather than moving the only copy.

Find and download a game

  1. Add a download client (qBittorrent, Transmission, SABnzbd, NZBGet, built-in Usenet, and more) under Settings → Download Clients. Use Test.
  2. Add a search source: Prowlarr, a Torznab/Newznab indexer, or a torrent RSS feed, under Settings → Indexers.
  3. Search one game with Interactive Search. You'll see each release's score and why it was accepted or rejected before you grab it.
  4. Follow it through Queue (with qBittorrent progress and ETA) and History.

To keep looking for a game automatically, add it from Games → Add New. See Wishlist and Monitoring.

Optional: DAT verification

Load No-Intro or Redump DATs to verify files, name them consistently, and see which games in a set you're missing. See FEATURES.md.

If the first import fails

Symptom Check
No search results The source's Test, the platform and title, and Prowlarr's indexers
Found a release but can't grab it A client is configured for that protocol (torrent or Usenet)
Download finished but import can't find it The download mount and remote path mapping
Import fails writing the library ROMarr can write there; PUID/PGID match the folder's owner
RomM doesn't show the game RomM scans the same folder and its rescan finished

More in Troubleshooting and GETTING-STARTED.md.

Clone this wiki locally