Skip to main content
fix repairs your library’s metadata so albums group correctly and show art on the iPod. It writes back to your files in place, never moving or renaming them (other tools like Plex read the same files, so paths stay stable).
A run reports what it touched and skips anything the catalog already knows is complete:

​
What it does

A three-step pipeline:
  1. Repair album artist: so compilations and multi-artist albums group correctly.
  2. MusicBrainz: fetch missing cover art and release year.
  3. Last.fm: fetch genres (needs a Last.fm API key).
All three steps are index-driven (no filesystem walks for already-clean state) and cache both positive and negative results in SQLite, so re-running on an unchanged library does zero network work. It all runs on the base install, no extra packages required. The genre step uses the same Last.fm API key as scrobbling (read-only, no --auth required). Without it, genres are skipped with a warning and the other steps still run.

​
Refreshing

Cached results are reused on every run. To force a re-fetch: