Repository navigation
Soundtracks
ROMarr can find a game's soundtrack and add it to RomM's Jukebox. Open Library → Soundtracks, choose a RomM library, then a game. The page only appears once a RomM library is configured.
Search for a soundtrack lists ranked candidates from Zophar's Domain and the Internet Archive, plus manual-search links (KHInsider, VGMRips, MusicBrainz, Bandcamp, YouTube). You can edit the search words. Pick a format and ROMarr downloads it, takes only the audio out of any archive, and uploads each track through RomM's own API. ROMarr never writes into your ROM folders; RomM creates the soundtrack/ folder itself.
RomM accepts MP3, OGG, OPUS, M4A, AAC, WAV, FLAC, SPC, VGM, VGZ and GYM. Other chiptune formats are skipped.
Set music_library_root to a read-only music folder. You can then pick an album by typing its name or browsing folders, and send it to a game.
- Undo removes exactly the files ROMarr added for that game, on the RomM server they were sent to, and nothing else.
- Duplicates finds identical soundtracks (compared by SHA-256), merges them, and can restore the merge.
- Files are read through pinned handles. A folder or file that changes after you pick it can't redirect ROMarr to a file outside that folder.
- Downloads follow only checked redirects, with size limits and a cap on concurrent jobs.
- Archives are streamed, never extracted to disk, and names are flattened.
- One request per second per site.
ROMarr uses the login saved on the RomM library entry. For uploads it requests a token that can edit ROMs; day-to-day reads stay read-only. A fixed API token must itself be allowed to edit ROMs.
Soundtrack media and third-party catalogues have their own rights; ROMarr bundles no audio.
Full guide: SOUNDTRACKS.md.
ROMarr is MIT licensed · Report a problem · Detailed, release-tracked docs live in the repository's docs folder.