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.

Status

Works today:

• Validate a config file (romledger config)
• Download No-Intro and Redump DATs (romledger dats update)
• Match your library and inboxes to the DATs (romledger scan)
• Show progress per platform (romledger status)
• List missing games, with Vimm's Lair search links (romledger missing nes --links)
• Import from the inboxes into a per-platform folder layout (romledger import)
• Browse progress, missing games and the inbox, and upload files, in a local dashboard (romledger serve)
• Download missing games from CoolROM and the Internet Archive (romledger fetch)
• Mark games as in your library or missing while you browse Vimm's Lair, CoolROM and the Internet Archive (browser extension)
• Check that the supported sites and the igir pin still match (romledger canary; runs weekly in CI)

Vimm's Lair is manual; see docs/sources.md.

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

Create ~/.config/romledger/config.toml:

[library]
roms = "~/roms/library"
inboxes = ["~/roms/inbox"]

[platforms.nes]

Both directories must exist. Platform names are the folder names RomM uses, such as nes and snes. An unknown name makes romledger config print the known ones. dat is filled in for known platforms.

Check it, then fetch DATs and scan:

romledger config
romledger dats update
romledger scan
romledger status
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.