I wanted to share the release of v1.0 of the Plex Linter. I upgraded the codebase somewhat, sped up some operations, and added some additional linting checks.
The issues the linter can detect:
- Duplicate album titles (for albums that have perhaps been incorrectly split)
- Duplicate artists (for artists that have potentially been split)
- Tracks without titles (sometimes Plex metadata deletes track titles)
- Tracks linked to artists with Plex metadata that different from what the MP3 tags say (requires running on the plex server and using the
--localflag) - Tracks with albumartistsort set (this can cause issues sometimes so is better to not have it set)
- Tracks that plex thinks are Various Artists that don’t have MP3 tag album artist set as “Various Artists”
- Tracks where plex artist is not the same as MP3 tag album artist
- Note that the linter only works for music libraries currently
The linter doesn’t fix anything, it only reads from your plex server and (if you pass the --local flag) your local file system to check mp3 tags - but it will print out things that you might want to look at and consider fixing with an MP3 tag editor.
Using this I was able to get my library in good shape and finally sorted out the various-artists mess that has plagued me for a while.
Anyway please give it a spin and let me know if it helps you, or if you run into any issues.
