media-library-organizer

# Media Library Organizer ## Overview Systematically clean, merge, rename, and verify media libraries so that Jellyfin/Emby/Plex can correctly identify and scrape all content. ## When to Use - Media directory has messy folder names with encoding info - Same show scattered across multiple folders - Junk files wasting space - Need to verify episode completeness against TMDB ## Workflow ```dot digraph media_org { rankdir=TB; "1. Scan & Analyze" -> "2. Clean Junk"; "2. Clean Junk" -> "3. Identify Duplicates"; "3. Identify Duplicates" -> "4. Merge Scattered Episodes"; "4. Merge Scattered Episodes" -> "5. Normalize Folder Names"; "5. Normalize Folder Names" -> "6. Verify vs TMDB"; "6. Verify vs TMDB" -> "7. Report & Confirm Deletion"; } ``` ## Steps Each step has detailed instructions and reusable scripts: 1. **[Scan & Analyze](docs/scan-and-analyze.md)** - Survey directory, identify issues, generate report - Script: `scripts/scan-media.sh` 2. **[Clean Junk](docs/clean-junk.md)** - Remove temp files, empty dirs, orphan fragments 3. **[Identify Duplicates](docs/identify-duplicates.md)** - Find same content across folders by title/year matching 4. **[Merge Scattered Episodes](docs/merge-scattered-episodes.md)** - Combine split episodes into one folder - Script: `scripts/check-episodes.sh` 5. **[Normalize Folder Names](docs/normalize-folder-names.md)** - Rename to `Title (Year)` format - Script: `scripts/normalize-names.sh` 6. **[Verify vs TMDB](docs/ve...