Skip to content

Soundtracks

BlizzHacker edited this page Nov 17, 2026 · 1 revision

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.

Find a soundtrack

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.

Albums from your music folder

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 and duplicates

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

Safety

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

Sign-in

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.

Clone this wiki locally