I built a Jellyfin library health scanner for myself — here's what it found
Updating this a bit as I have learned more about how these types of things needs to be posted. Thank you for those that have helped explain and clarify.
Here is the gitlink. It will download a .exe file.
https://github.com/packscopeio-dev/mediaiq-releases/releases/download/v1.0.0/MediaIQSetup.exe
Once downloaded you can get a free license at the site references in the set up page. 100% free. At the momenet this is just a personal project that I have been using personally and thought others might enjoy too. It is not open source but free with a license for the next 30 days. (that is the time frame I have available to commit to this project right now) I don't know what I will do with it after that - might extend that trial window, might take it down, might open source. I am new to all of this so I am also learning all of my options related to distributing this the right way.
Would greatly appreciate any feedback you might have if you give it a try.
🔑 Setup:
MediaIQ requires free API keys from TMDB, TVDB, and OpenSubtitles. The app walks you through getting each one on first launch — takes about 5 minutes. All three services have free tiers that are more than enough for personal use. Opensubtitles has a free teir with a limited number of downloads each day. Or you can pay them for more usage. I get nothing if you pay them for high download numbers and I am not affiliated with any of these sites in any way.
💻 Windows only. Runs entirely locally — your files and library data never leave your computer.
____________________________________________________________________________________________________________
🎬 What MediaIQ does:
- Missing Collection Detection — scans your movies against TMDB and flags which films you're missing from franchises you already own. If you have Iron Man it finds that Iron Man 2 and Iron Man 3 are missing.
- Missing Episode Tracking — checks every show against TVDB and reports gaps by show and season so you know exactly what's incomplete
- Quality Report — scores every file 0-7 based on resolution, codec, and container. Sorted highest score first so you know exactly what to replace first. A 1080p H264 MKV scores 0 — that's your target.
- Subtitle Management — finds missing subtitles and downloads them automatically in up to 25 languages using hash-matched accuracy so you get the right subtitle for your exact file
- Duplicate Video Scanner — finds multiple video files for the same title and shows a side-by-side quality comparison so you can delete the worse copy confidently
- Folder Cleanup — flags junk files (.txt, .db, .url etc). Never touches video, subtitle, or artwork files. Everything goes to the recycle bin — never permanently deleted.
- Library Health Score — a single number from 0-100 that summarizes the overall state of your library across quality, completeness, and subtitle coverage. The goal is 100.
____________________________________________________________________________________________________________
I have a small Jellyfin library and had no idea what state it was actually in. So I built a tool to tell me.
Turns out my library health score was not great.
34 movies missing from franchises I already own. Several shows with season gaps I didn't know about. A bunch of low resolution files I thought were fine. Subtitles missing on more movies than I expected.
Here's what the quality report looks like — sorted worst score first so I know exactly what to replace.
And the overall health dashboard*.*
Just started working on subtitles so those clearly need some attention.
Took about 45 minutes to scan 750 movies and 3,500 episodes and generate the full report.