r/MediaClinic • • 12d ago

MediaClinic 0.19.4 is out: movie collections, a new layout, and a full code review (Windows exe included)

Post image
2 Upvotes

0.19.4 is out, and this is the first Windows .exe since 0.19.1. 0.19.2 and 0.19.3 were source-only.

Download: github.com/junqueirach/mediaclinic/releases/latest

Unzip MediaClinic-0.19.4-win64.zip to a folder you can write to (not C:\Program Files) and run MediaClinic.exe. No Python needed. The SHA-256 is in the release notes.

What's new

  • Movie collections (Kodi movie sets). The scan now reads each movie's collection from the NFO and movie.xml. There is a Collection column, a "Group by collection" view, and Check Collections Online (TMDB). You can Fix / Set / Rename / Join / Remove a movie's collection, and Sync Collection keeps NFO and movie.xml in step.

  • One name per collection. It's English, unless more than half of the titles are in another language. You can also fix a language in Settings.

  • Collection Artwork. Pick the set's poster and fanart from TMDB, a TMDB search, or the movies' own images. "Create Collection Folder" builds Kodi's movie set information folder.

  • Renaming a collection moves its folder and images with it, and Undo puts everything back.

  • New layout. There is a header, a toolbar, a status bar with the FFmpeg / FFprobe switch, and a panel for the selected movie with a Fix button for each issue.

  • Help rewritten. 13 topics with a contents list.

  • Full code review. Writes and Undo are safer, and a scan that fails keeps your previous rows. Every fix now shows at once in the row and the panel, and more work runs in the background.

  • A random freeze is fixed. The window could lock up for good when a background job started. CI found it on Python 3.10.

  • Backups moved to %APPDATA%\MediaMetadataClinic\backup, so updating no longer loses Backup History and Undo. Older backups move there once.

Full list: CHANGELOG

Good to know

  • The exe is not code-signed, so Windows SmartScreen may warn. Click "More info", then "Run anyway".

  • Every file MediaClinic overwrites is backed up first, but I'd still try it on a copy of a library the first time.

  • FFmpeg / FFprobe are optional and a separate download.

I'm still looking for people with large collections to test

I've tested on a small sample library: scan, FFprobe, fixes, Undo, Excel export and collections. I haven't tested thousands of movies, network shares, or the odd naming that real libraries pile up over the years, and that is where I expect the remaining bugs.

If you have a big library (Kodi, Emby, Jellyfin or Plex style folders, local or on a NAS), please try it and tell me what happens. Slow scans, wrong collection names, false warnings and crashes are all useful. If something goes wrong, logs\app.log next to the exe is the most helpful thing to attach.

Reply here, open an issue on GitHub, or write to [email protected].

Thanks to everyone who has already tested and reported.


r/MediaClinic • • 2d ago

MediaClinic 0.19.6: you now choose which files are checked (NFO only for Kodi / Jellyfin / Emby / Plex), plus fixes from the first testers

Post image
1 Upvotes

0.19.6 is out. This release is mostly an answer to what the first outside testers of 0.19.4 found. Thank you to everyone who tried it and wrote back.

Download: github.com/junqueirach/mediaclinic/releases/latest

Unzip MediaClinic-0.19.6-win64.zip to a folder you can write to (not C:\Program Files) and run MediaClinic.exe. No Python needed. The SHA-256 is in the release notes.

The big change: "Which program plays your movies?"

The most common feedback was that MediaClinic warned about movie.xml files that most people don't have or need. Now the app asks once at the first start:

  • Kodi, Jellyfin, Emby, Plex, Infuse… (recommended): only the NFO is checked. The .xml column and every movie.xml warning are gone.

  • The same plus old Windows media centers (MediaBrowser, Media Center Master): NFO and movie.xml.

  • Only old Windows media centers: movie.xml only, the NFO is not read or written.

You can change it later in Settings → Health Rules → Health mode. Everyone sees the question once, also after an update.

Also new or fixed

  • Health Rules in four parts: general rules (with topic subtitles), NFO rules, movie.xml rules, and NFO-vs-movie.xml comparisons. Parts your mode doesn't use are grayed.

  • Sync Ratings now works for movies that have only an IMDb ID (TMDB is asked by that ID), and the end message names any movie that was skipped and why.

  • Movies inside folders of folders (up to five levels deep) are found and keep their library, instead of being listed as ignored.

  • Linux from source: a MediaClinic.sh launcher that tells you what's missing, column headings and Settings tabs no longer cut off, files open with xdg-open. Checked on Ubuntu under WSL; macOS is not tested.

  • The update to a newer version starts from a background thread, so the window stays responsive.

Full list: CHANGELOG

Good to know

  • On the first start, rows saved by an older version are read once more.

  • VirusTotal: 0 of 71 engines flag this exe. It's compiled with Nuitka, like 0.19.5.

  • The exe is not code-signed, so SmartScreen may warn. Click "More info", then "Run anyway".

  • Every file MediaClinic overwrites is backed up first, but I'd still try it on a copy of a library the first time.

Still looking for people with large collections to test

It's tested on a small sample library only. If you have thousands of movies, a NAS, deep folder trees, messy naming or lots of sets, please try it and tell me what happens. Slow scans, false warnings and crashes are all useful. logs\app.log next to the exe is the most helpful thing to attach.

Reply here, open an issue on GitHub, or write to [email protected].


r/MediaClinic • • 8d ago

MediaClinic 0.19.5 is out: a fix release after reviewing every feature (new Windows build, 0 of 69 on VirusTotal)

Post image
1 Upvotes

0.19.5 is out. It has no big new features: I went through every feature of 0.19.4, checked how tags are handled against what Kodi, Jellyfin, Emby and Plex actually read, and fixed what came up.

Download: github.com/junqueirach/mediaclinic/releases/latest

Unzip MediaClinic-0.19.5-win64.zip to a folder you can write to (not C:\Program Files) and run MediaClinic.exe. No Python needed. The SHA-256 is in the release notes.

What's fixed

  • Files stay valid. Empty and CDATA tags are filled in place, one-line NFO files stay valid, backslashes in values are no longer damaged, and a result that doesn't parse is never written.

  • Ratings under the right name. Sync Ratings no longer stores a TMDB rating as imdb, and the table shows the rating Kodi really shows.

  • Language OK counts audio and subtitle tracks only. Some movies will change from Y to N on the first start. That is correct, not a bug.

  • Fewer false warnings. h264 / AVC or ac3 / Dolby Digital are no longer reported as a difference, and your own collections are never warned about or removed.

  • IDs and dates. Fix IDs adds <uniqueid> and keeps the plain <id>, dates on a day/month PC are read right, and a new rule compares the year with the premiered date.

  • Saves no longer get lost when another program reads the file at that moment.

  • Complete Undo after image fixes and Replace All Backdrops.

  • A frozen window after a screenshot tool now recovers by itself within about 2 seconds.

  • Cleaner Settings. Four settings that did nothing are gone.

Full list: CHANGELOG

About the VirusTotal flags on 0.19.4

A tester found 2 of 63 engines flagging the 0.19.4 exe with generic names. I looked into it: the flagged part was PyInstaller's loader, not the app, and the sandboxes saw no network traffic or dropped files. To avoid the issue altogether, the 0.19.5 exe is now compiled with Nuitka (the Python code becomes C). The trial of that build scored 0 of 69. The zip is bigger now (about 32 MB). Thanks to the tester for reporting it. If you prefer, you can always run from source and read every line.

Linux and macOS

There is no download yet, but the app runs from source and the tests run on Ubuntu in CI. The README has the steps. I have only tested Windows by hand, so reports from Linux and macOS are very welcome.

Good to know

  • On the first start, rows saved by an older version are read again once, so Language OK, the rating and Date added can change for some movies.

  • The exe is not code-signed, so SmartScreen may warn. Click "More info", then "Run anyway".

  • Every file MediaClinic overwrites is backed up first, but I'd still try it on a copy of a library the first time.

Still looking for people with large collections to test

So far it's tested on a small sample library only. If you have thousands of movies, a NAS, messy naming or lots of sets, please try it and tell me what happens. Slow scans, false warnings and crashes are all useful. logs\app.log next to the exe is the most helpful thing to attach.

Reply here, open an issue on GitHub, or write to [email protected].


r/MediaClinic • • 23d ago

MediaClinic 0.19.2 and 0.19.3 are out: safer writes, sort builder, previews before every change (source releases, exe comes with 0.19.4)

1 Upvotes

Two new versions of MediaClinic, my free tool that checks a whole movie library's NFO/XML metadata and artwork and shows every problem in one table (Kodi, Jellyfin, Emby, Plex with NFO files).

How to get them

Both are source releases for now: download the source from GitHub and run `python mediaclinic.py` (Python 3.10 or newer, see the README). The Windows exe stays at 0.19.1, and the next exe comes with 0.19.4. Download page: https://github.com/junqueirach/mediaclinic/releases

What is new in 0.19.2

- Safer writes: settings.json is saved atomically, an NFO/XML that is not UTF-8 is never rewritten, & < > are escaped when written, and if a backup fails the change is stopped.

- Unhandled errors now go to logs/app.log (Help > Open logs folder), so a bug report can include the real error.

- Folders that are not movies (TV series, collections, system folders) no longer get a row. An "Ignored folders" window lists them.

- Naming rules for Kodi, Jellyfin, Emby and Plex: trailers, extras, stacked files, versions, editions and subtitle flags are understood, so they stop showing up as false problems.

- Fix image proportions / size. An optional AI upscale can be downloaded when you ask for it (the file's size and SHA-256 are checked first).

- Check for updates (off by default), a new rounded icon, a two-level right-click menu, and frame extraction that can no longer hang the PC.

What is new in 0.19.3

- Sort builder: up to three levels, any column, presets and Ctrl+1 to Ctrl+9, kept between sessions.

- "Not a duplicate" marks, "Make titles the same", and a rename of NFO files to the name Kodi expects.

- A preview before Normalize Sources, Sync Ratings, Copy poster > folder and Normalize Genres write anything.

- More content checks for NFO/XML: ID format, year, numbers, duplicate tags, wrong root element.

- Fix image runs in the background and can be minimised. Replace All Backdrops lets you choose how many to download.

- Faster start, and the line endings of NFO/XML files are kept.

Privacy, as before

No account, no tracking, no server of mine. Your library stays on your computer. The only internet connections are to TMDb/OMDb (and fanart.tv if you add a key), and only when you use rating sync, artwork download or ID checks, with your own API keys. Every NFO/XML is backed up before it is written, and video files are never touched.

How it was tested (honest version)

The automated tests run on Linux in CI with Python 3.10 and 3.12: about 1,085 self-test checks and 31 settings checks for 0.19.3 (938 and 28 for 0.19.2). Checks that need Windows (registry, backslash paths, the AI upscaler, window minimising, some shortcuts) are skipped in that run, so those parts rely on my own manual use on Windows. I built MediaClinic with Claude (Anthropic's AI) as the coding partner, and I am not a professional developer.

What I would like from you

- Run it on your library and tell me what breaks or confuses you. Large libraries, NAS shares and unusual folder layouts help most.

- Back up your NFO/XML files before the first run on a real library, as you would with any tool that writes metadata.

- Bugs and ideas: GitHub Issues https://github.com/junqueirach/mediaclinic/issues, or comment below.

Full list of changes: https://github.com/junqueirach/mediaclinic/blob/main/CHANGELOG.md


r/MediaClinic • • 23d ago

Two versions are comming

1 Upvotes

I revised the app twice and will upload the phyton code asap.


r/MediaClinic • • Oct 15 '26

MediaClinic 0.19.1: Kodi artwork naming, IMDb-only films, burned-in subtitles, undo, and a Windows download again

1 Upvotes

Version 0.19.1 is out, with a Windows exe again. Several fixes come straight from your feedback here and on r/kodi. Thank you!

🎯 From your feedback

  • Kodi artwork naming: posters and fanart named Movie (Year)-poster.jpg / -fanart.jpg (also .png and .tbn) are now found, instead of showing as Missing. A missing folder.jpg is no longer reported when a Kodi-style poster exists (you can switch this rule off). New artwork is saved in the naming style the folder already uses.

  • Newer Kodi NFOs: IDs in <uniqueid type="imdb|tmdb"> tags are read and kept up to date.

🆔 IDs and sources

  • Films that exist on IMDb but not on TMDb can finally be confirmed: Search Sources shows the movie’s current IDs and a Confirm IMDb button.

  • Type an IMDb or TMDb ID yourself with Enter ID…

  • When one ID is missing, empty tags are written for it, ready to fill in by hand.

  • Search also tries the library language and the original title.

🎧 Audio and subtitles

  • Burned-in subtitles: mark them yourself (right-click → Hard-coded subtitles…, one or more languages). They’re saved as tags that Kodi and Emby/Jellyfin understand, and they count for the language checks. (They can’t be detected automatically.)

  • When FFprobe finds no audio language, the language from the NFO/XML is used. FFprobe always wins when it has one.

🖼️ Artwork

  • fanart.tv as a second image source, next to TMDb (free API key).

  • Frames from the movie as fanart or backdrops (needs FFmpeg).

  • Replace All Backdrops warns you before leaving you with fewer backdrops than you have now.

  • The Fetch dialogs now say Done instead of Cancel.

🛡️ Safety and reliability

  • Undo: Tools → Backup History… restores a whole batch of NFO/XML changes.

  • Clear messages when TMDb or OMDb don’t answer, with advice (for example “wait a minute” or “OMDb’s free daily limit is used up, try again tomorrow”). A paused service is remembered, even after a restart.

  • Exact NFO/XML error messages: every error with its line, column and tag name.

  • Genres are read from both NFO and XML, and Normalize Genres can fetch genres when a movie has none.

  • Deleted movie folders leave the table automatically.

⚡ Everyday use

  • FFprobe results are cached, so a second scan of an unchanged library is much faster.

  • Progress and Cancel on every long operation.

  • Shift+PageUp/PageDown extend the selection, Ctrl+A selects all, and the status bar shows “N selected”.

  • After changing your libraries, the app offers to scan.

  • The Help menu has one entry per topic, with cleaned-up texts.

📥 Download
MediaClinic-0.19.1-win64.zip (about 19 MB): unzip and run MediaClinic.exe, no Python needed. Not code-signed, so Windows SmartScreen may warn (More info → Run anyway). The SHA-256 is in the release notes.

👉 https://github.com/junqueirach/mediaclinic/releases/latest

Self-test: […] checks, all passing. The full list is in the CHANGELOG.

Next up (0.19.2): a preview before every bulk tool, more NFO/XML structure checks, and faster start-up on very large libraries.

Feedback and bug reports are welcome below or on GitHub. 🙏


r/MediaClinic • • Oct 14 '26

What's new in MediaClinic 0.19.0: multiple libraries, ID verification and Auto Repair

1 Upvotes

Version 0.19.0 is out on GitHub. It’s the biggest update so far. Here’s what changed:

Several libraries in one table

  • Add all your movie folders (for example a local disk and a NAS) in the new Libraries… dialog

  • A library filter next to Browse… limits the table and the scans to one library

  • An optional Library column, and duplicates are now found across libraries too

  • If a drive is offline, its movies stay in the table from the last scan instead of disappearing

Verify IMDb/TMDb IDs

  • Checks every movie’s IDs against TMDb: title (in any translation) and year (±1)

  • Finds the classic problems: same-name films, wrong year, an ID pointing to another movie, NFO and XML disagreeing

  • Results go into a sortable report you can save as .txt or .csv

  • Works for the whole library, a selection or a single movie (right-click)

Auto Repair

  • Fixes IDs, ratings, genres, year, titles and the XML language tag in one go

  • Dry-run preview first: you see what would change before anything is written

  • Clear matches are applied automatically; ambiguous ones show a chooser with posters

  • A backup is made before the first change, and a summary shows fixed / skipped / still failing

  • Artwork is never touched by Auto Repair

Better image checks

  • Small images were wrongly reported as corrupt. Now each problem has its own status: missing, corrupt (can’t be opened), too small, wrong proportions, or wrong format for the extension (for example a PNG named .jpg)

Other fixes

  • Every NFO/XML write is now atomic: a crash or power cut can’t leave a half-written file

  • Fixed a bug where adding an ID could damage a movie.xml with a <Title> root

  • Sync Ratings: one choice for all zero-vote movies, and 0.0 / 0 is never written

  • The table refreshes automatically after every change

  • Window sizes and positions are remembered

How to get it
0.19.0 runs from Python source for now. The Windows exe comes with 0.19.1 in the next days, which will also support Kodi’s own artwork naming (Movie (Year)-poster.jpg), thanks to feedback from r/kodi. The 0.18.4 exe is still available.

👉 https://github.com/junqueirach/mediaclinic

Full details are in the CHANGELOG. Questions and bug reports are welcome below.


r/MediaClinic • • Oct 14 '26

👋 Welcome to r/MediaClinic - Introduce Yourself and Read First!

1 Upvotes

MediaClinic is a free, open-source Windows tool for people who keep their own movie library for **Kodi, Jellyfin, Emby or Plex (with NFO files)**. It scans a folder-per-movie library and shows every metadata and artwork problem in one table, then helps you fix the common ones safely.

👉 GitHub (download, screenshots, changelog): https://github.com/junqueirach/mediaclinic

What it does for now
- Reads Kodi .nfo and Emby/Jellyfin movie.xml, local or on a NAS
- One colour-coded table: red errors, yellow warnings, with the reason for each
- Checks artwork: missing, corrupt, too small, wrong proportions
- Optional FFprobe check: resolution, audio languages, subtitles
- Verifies that IMDb/TMDb IDs point to the right film
- Fixes: genres, ratings, artwork, IDs, with a dry-run preview and a backup of every file before it changes
- Private by design: no account, no tracking. Your library stays on your computer. It only talks to TMDb/OMDb when you use those features, with your own free API keys.

Current status
- Windows exe: v0.18.4. Newest version: 0.19.0 (Python source).
- Coming in 0.19.1: support for Kodi's own artwork naming (Movie (Year)-poster.jpg, -fanart.jpg), thanks to feedbacks from r/kodi

How to take part
- 🐞 Bugs: open an issue on GitHub (best), or post here with the *Bug* flair. A screenshot and your folder layout help a lot.
- 💡 Ideas: post with the Feature request flair.
- 🧪 Testers wanted: large libraries, NAS shares, unusual folder layouts, Linux/macOS from source.
- 🛠️ Developers: Python/Tkinter, small pull requests welcome (see CONTRIBUTING.md).

About the project
I'm not a professional developer. I built MediaClinic with Claude (Anthropic's AI) as the coding partner, test every version on my own library, and keep every earlier version on GitHub. An automated test suite runs on every change.

Rules in short:
be respectful, no piracy or requests for copyrighted content, and keep it about managing your own media library.

Thanks for stopping by.

Questions are welcome in the comments.