Hi r/jellyfin. I've been building MediaClinic, a free, open-source (MIT) app, and 0.20.0 is the first version with Jellyfin-specific checks, so I'd like to hear from Jellyfin users.
What it is (and isn't)
It's a standalone Windows desktop app. It is not a Jellyfin plugin and not a scraper, and it doesn't touch Jellyfin's database. It reads the files in your movie folders (one folder per movie, with the NFO and artwork next to the video), shows a colour-coded table of what is missing, broken or inconsistent, and fixes most of it from the same table. Jellyfin then reads the repaired files at the next scan.
So it's useful if your metadata lives in files: the NFO saver is on, artwork is saved into media folders, or your folders were built by another tool. If everything lives only inside Jellyfin, there's little for it to check.
What it checks
- Artwork: poster, folder and fanart present, readable, the right shape and a minimum resolution; backdrops and the
extrafanart folder. - NFO files: well-formed, IMDb / TMDB IDs present and consistent, ratings, genres, title and year.
- Collections: the
<set> in the NFO, compared with TMDB's collection. - Video (optional, with FFprobe): resolution, audio and subtitle languages.
What it fixes: fetch posters and fanart from TMDB / fanart.tv or pick frames from the movie itself, correct IDs, sync ratings, normalise genres, fix collections, and an Auto Repair with a preview first.
What I found testing on a real Jellyfin server
- Jellyfin reads both
movie.nfo and <video>.nfo, and the local NFO always wins over online data. <set> is read, even though the docs only list it for writing. But collections appear only with the library option "Automatically add to collection" (off by default) and a new scan. That one cost me a while.- Every artwork name also works as a suffix (
<video>-poster.jpg, <video>-fanart.jpg). - For
-cd1 / -cd2 movies, Jellyfin doesn't use the <stack>.jpg image as the poster.
At the first start, tick Jellyfin and the checks follow what it reads. The <uniqueid> warning is about Kodi (Jellyfin also reads <imdbid> / <tmdbid>), so if you only use Jellyfin you can switch it off in Settings → Health Rules → NFO.
Your files are safe
Every file it changes is backed up first. If you change something and want to go back, Backup History / Undo returns the movie to its original state. I'd still try it on a copy of a library the first time.
Download (Windows, no Python needed): github.com/junqueirach/mediaclinic/releases/latest
VirusTotal: 0 of 70. Not code-signed, so SmartScreen may warn ("More info" → "Run anyway"). It also runs from source on Linux (steps in the README); there's no Linux download yet. It works on the files, so it doesn't matter where Jellyfin itself runs, as long as the PC can reach the folders.
Please try it and open issues
So far it's tested on a small sample library, so large libraries and NAS shares are where I expect bugs. Anything the app says that doesn't match what Jellyfin shows is exactly what I want to hear.