romledger

Track which retro games you have and which are missing, verified against No-Intro and Redump DATs. It runs on one computer: point it at a folder of ROMs and it reports, per platform, what is there and what is not.

How it works

1. Run romledger init once. It creates the config file, library/ and inbox/.
2. Download a game: use the browser extension on Vimm's Lair, drop or upload files in the dashboard, or run romledger fetch. The files land in the inbox.
3. Import. Under romledger serve it runs by itself; otherwise press Import in the dashboard or run romledger import. Each file is checked against the DAT, renamed to its DAT name and filed under library/<platform>/.
4. Files that do not fit are set aside inside the inbox, never deleted: inbox/unmatched/ (not in any DAT), inbox/unwanted/ (a valid dump you did not ask for) and inbox/duplicates/ (you already have it).

The inbox is a plain folder. Copy files into it yourself, zipped or not, and the next import processes whatever is there. A zip is matched by the ROM inside it, so you do not unzip it.

How it fits

• igir matches files to DATs and moves them into place.
• romledger decides what you have and what is missing.
• RomM is optional. The library layout is RomM's folder naming (roms/<platform>/), and romledger works the same without RomM.

Install

Requires Python 3.11+ and Node.js 22.22+ (romledger runs igir through npx).

uv tool install romledger

or, with pipx:

pipx install romledger

Configure

romledger init

It asks for a ROM folder and the platforms to track, creates <roms>/library and <roms>/inbox, and writes ~/.config/romledger/config.toml. romledger platforms lists the platform names. Without a terminal, pass romledger init --roms ~/roms --platform nes --platform snes.

Then fetch the DATs, scan and open the dashboard:

romledger dats update
romledger scan
romledger serve --open

See docs/setup.md for all options, docs/deploy.md to run it as a container, docs/extension.md for the browser extension, docs/playing.md to play what you collect, docs/sources.md for download sources and docs/troubleshooting.md for error messages.

To work on romledger, see CONTRIBUTING.md.