Skip to content

Imports and Archives

BlizzHacker edited this page Nov 17, 2026 · 1 revision

Imports and Archives

ROMarr imports finished downloads into your library without losing the download: it copies or hard-links rather than moving the only copy, so torrents keep seeding.

Archive formats

Format Notes
.zip Built in
.7z, .rar Via the bundled archive tools (bsdtar); RAR volume sets are read through their first volume
.tar, .tar.gz/.tgz, .tar.bz2/.tbz2, .tar.xz/.txz Built in, new in 1.11
Nested ZIPs ZIPs inside ZIPs are verified too

Members are streamed out one at a time; archive paths are never extracted to disk. ROMarr refuses archives that contain links, device files, sparse files, path traversal (../), names that differ only by case, or members whose size or compression ratio exceeds safe limits.

For MAME, FBNeo and DOSBox the ZIP is the ROM, so it's imported as-is. A ZIP wrapped in a .tar.gz is unwrapped first, since no emulator loads a .tar.gz.

A release name like Game.[Group].tar.gz loses the whole .tar.gz, not just .gz.

Previews and review

Manual Import and the import preview show what ROMarr would import, from which archive, to where, before anything changes. If a download holds several candidate games or discs, you choose which to import.

Duplicates

Exact duplicates (by hash) are detected before import and can be audited, quarantined and restored later. See IMPORT-DUPLICATES.md.

Full guides: IMPORTS.md, import-selection.md.

Clone this wiki locally