🧹

CineLibrary Essentials

Clean up messy movie and TV-show downloads. Rename, organize, and scrape full metadata into the folder layout Plex, Kodi, Jellyfin and MediaElch expect - fast, offline, no admin required.

WinUI 3 · .NET 10 · x64 · Portable installer (~58 MB) · MIT licensed

The 3-stage workflow

CineLibrary Essentials takes a chaotic Downloads folder and turns it into a polished, library-ready movie collection in a single pass - no other tool required.

1️⃣ Essentials (this app)

Rename, organize and scrape movies and TV shows into the standard Title (Year)/ and Show/Season XX/ layouts - full Kodi NFO with director, writers, country, studios, certification, trailer, complete cast with photos, probed file info, and per-episode metadata for TV.

2️⃣ MediaElch (optional)

If you want to layer in extra sources or edition-specific data, MediaElch reads the folders Essentials prepared. Not required - Essentials now produces equivalent NFO output on its own.

3️⃣ CineLibrary

Scan and browse the finished library across multiple external drives. Reads the full .nfo, poster, fanart, and actor photos Essentials produced.

What it does for you

🧠 Smart filename parser

Strips release-group prefixes, codecs (x265, HEVC, AV1), audio (DDP5.1, Atmos), HDR, source tags, and tracker URLs. Extracts the real title and year. Add your own words to always remove for the tags it doesn't know.

🟥 Word-level diff

Each row shows the original filename with kept tokens grey and removed tokens in red strikethrough - see exactly what was cleaned.

🪄 Inline TMDb search

Per-row 🔍 button opens a TMDb search dialog - pick the right match, app uses that exact ID for metadata download.

📁 Drag-and-drop

Drop a folder onto the window. Recursive scan toggle for whole libraries. Subtitle files (.srt, .sub) follow the rename automatically.

🛠 Bulk power tools

Find & Replace, Smart Title Case, output template picker (Title (Year) or Year - Title), Reset, Select all, a one-click Show only warnings view, and keyboard editing (F2, Enter, Delete).

⚠️ Safety first

Confirms before destructive ops. Detects duplicates, invalid characters, missing year, TV episodes, and path-too-long issues per row.

📜 Full Kodi-standard NFO

Director, writers, country, studios, certification, tagline, collection/set, trailer URL, IMDb & TMDb ids, structured ratings, and a probed <fileinfo> block with video codec, duration, and per-track audio & subtitle languages.

🖼 Complete cast with photos

Up to 50 cast members per movie, each with a high-resolution headshot from TMDb saved into .actors/. Downloaded in parallel, idempotent on re-scrape.

🧹 MKV metadata cleanup

Optional in-place scrub of pirate site branding (HDHub4u titles, embedded logos, junk tags) using the bundled mkvpropedit. Only the metadata block is rewritten - the video, audio and subtitles are never re-encoded.

🔔 One-click auto-update

Silent once-per-24h check against GitHub. When a newer release is published, the toast that appears can download and launch the installer for you - no browser, no manual download.

⚙️ Settings page

One place for the output template, recursive scan default, embedded-metadata cleanup default, words to always remove, the TMDb scrape language, the main rating (IMDb or TMDb), episode titles in file names, and the auto-update preference.

🌐 Scrape in your language

TMDb metadata in Burmese, Hindi, Tamil, Telugu, Thai, Chinese, Japanese, Korean and 8 others - localized titles, plots and posters, with English fallback where needed.

🎬 Edition detection

Director's Cut, Extended, IMAX, 4K Remaster, Theatrical, Unrated, Criterion, Open Matte and more are auto-extracted from messy filenames. Shows as a chip and writes <edition> to the NFO so Plex / Kodi group multiple cuts correctly.

🔎 Rich Movie Details view

Double-tap a scraped movie in Step 3 to open a polished, resizable details window - hero fanart, floating poster, full plot, IMDb and TMDb ratings, color-coded director / writer / studio / country / genres / IDs / file info, scrollable cast strip with photos, plus one-click Play and Open Folder.

✏️ Full NFO editor

Right-click any card → Edit NFO: a resizable editor for every detail field, genres and tags with suggestions from your library, the cast, TV episodes, and artwork picked from everything TMDb has. Fetch any field from TMDb in another language, bulk-edit many titles at once, and restore the previous version of any save.

⭐ IMDb + TMDb ratings

Every NFO gets both ratings with vote counts, and you pick which one players show first. Refresh IMDb ratings updates them for your whole library in one quick request, without re-scraping anything.

📺 TV show support

Full pipeline for TV: cleans episodes to Show - S01E01, organizes into Show/Season XX/, and scrapes tvshow.nfo + show artwork + per-episode NFO and thumbnails. Recognizes flat "Season Complete" folders too, and a show kept in one folder per season becomes one show, with the cast of every season. Optionally adds the real episode title to file names, with Undo.

🧩 Missing episodes

TV cards count seasons and episodes, and a show's details window lists every episode with thumbnail and air date, plus the aired episodes you don't have yet. Unaired episodes and specials are never counted as missing.

✅ Verify your library

Fill gaps only sweeps an existing library and scrapes just the folders missing an NFO, poster, fanart, or actor photos - skipping the ones already complete.

Wizard at a glance