Repository navigation
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.
| 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.
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.
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.
ROMarr is MIT licensed · Report a problem · Detailed, release-tracked docs live in the repository's docs folder.