Repository navigation
Getting Started
BlizzHacker edited this page Nov 17, 2026
·
1 revision
Open Settings → Setup Guide (/#setup). You can skip any step and come back later.
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.
- Put one file in the downloads folder ROMarr can see.
- Open Manual Import and scan that folder.
- Check the detected platform and the verification result.
- Press Import.
Your original download is kept. ROMarr copies or hard-links into the library rather than moving the only copy.
- Add a download client (qBittorrent, Transmission, SABnzbd, NZBGet, built-in Usenet, and more) under Settings → Download Clients. Use Test.
- Add a search source: Prowlarr, a Torznab/Newznab indexer, or a torrent RSS feed, under Settings → Indexers.
- Search one game with Interactive Search. You'll see each release's score and why it was accepted or rejected before you grab it.
- 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.
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.
| 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.
ROMarr is MIT licensed · Report a problem · Detailed, release-tracked docs live in the repository's docs folder.