media-shelf
Offline folder-scanning media picker. Browse local film + TV folders with TMDB posters, then copy what you want to a destination — no Sonarr/Radarr required.
media-shelf is a sibling of Media Holiday Cache, but for environments where Sonarr and Radarr aren’t reachable. Instead of querying *arr APIs, it scans local folders directly, parses titles and years from filenames, and asks TMDB for posters and metadata.
Each item gets a match-confidence label — high / medium / low / none — so you can spot-check the edge cases. Anything below medium gets a Fix match button that opens a TMDB search modal where you can pick the right title yourself. Posters are cached locally, so subsequent launches don’t need internet.
Forked from media-holiday-cache (FastAPI + React + Electron shell, copy engine, conflict modal, SSE progress) and media-library-audit (S##E## episode regex, ≥50 MB film-integrity gate). Same portable Windows .exe packaging chain — just a different brain.
Features
- Scans one or more local folders for films and TV shows
- Identifies titles from filenames (year-aware, scene-tag stripping)
- TMDB poster lookup with high/medium/low/none match-confidence scale
- Synopsis (overview) and genre tags on every film and show — v0.2
- Hover a poster to read the synopsis; filter the grid by genre — v0.2
- Manual 'Fix match' modal for low-confidence titles
- Local poster cache — works offline after first scan
- Films grid + Shows tab with seasons/episodes selection
- Conflict detection for files already at the destination
- Async chunked file copy (16 MB) with live SSE progress
- Portable Windows .exe via Electron