I got tired of manually renaming 89,000 releases so I built a tool
Been collecting for years and always kept my library consistent — [CAT001] Artist - Title (Year) — but doing it by hand folder by folder was killing me.
Built discogs-cleaner. You point it at a folder, it looks up each release on Discogs and renames everything automatically. Handles catalog numbers, year prefixes, scene naming formats, underscores — pretty much anything messy.
There's a browser-based version that needs no install, and a Windows desktop app that lives in your system tray and auto-updates. I want this to be polished, so totally open to help and config req's. I am a music h o a r d e r, I don't know why I didn't do this sooner. (I mostly source and own .flac, so I personally don't attribute the filetype. I can add this in the future).
Both free, open source!
Two versions:
- Web UI — open
index.htmlin your browser, no install needed. Paste folder names, fetch, review, apply. github.com/nmyriad/discogs-cleaner - Desktop app — native Windows installer, runs in your system tray, auto-updates. github.com/nmyriad/discogs-cleaner-desktop
Features:
- Dry run mode before anything touches disk
- Inline editing of proposed names before applying
- Undo last batch
- Auto-backoff when hitting Discogs rate limits
- Writes a
discogs-cleaner.txtstamp to each renamed folder with date + Discogs URL - Session + lifetime rename counter (somewhat working, will be fixed asap)
To Be Added:
- Choice of file arrangement, i.e. Year - Artist - Release - Catalog # and vice versa.
- v1.5.2 stats bar — still needs the submodule bump and rebuild to show in the desktop app
- Track verification (v1.5.0 roadmap) — cross-reference audio files against Discogs track count before applying
- Result picker — let you choose from top 5 Discogs hits when the first match looks wrong
- Recursive label mode — walk an entire Labels directory instead of one folder at a time
As some of you know, this is as reliable as the records in Discogs, but you have opportunities to vet the information before it's overwritten.
You'll need a free Discogs API key to use it. Happy to answer questions.