# Changelog

All notable changes to the Media Sorter project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.1.0] - 2026-09-07

### Added
- **Robust Long-Running Anime Tokenization & Season/Episode Extraction**:
  - Full support for 4-digit episode numbers (`\d{1,4}`) across standard TV tags (`S01E1171`) and standalone episode prefixes (`EP1171`, `E233`).
  - Added support for anime releases with episode titles (`[Anime Time] One Piece - 0233 - Episode Title [Tags]`), space-separated formats (`[HatSubs] One Piece 1073...`), and underscore formats (`[Kaerizaki-Fansub]_One_Piece_1076...`).
  - Parent directory season extraction (`Season 08 - Water Seven`) scanning ancestor paths from closest to farthest while ignoring system root folders.
- **Natural Ordering & Web UI Auto-Detection**:
  - Implemented `natural_sort_key` in Python and `naturalCompare` in JavaScript so episodes never get misaligned or sequentially numbered out of order.
  - Added "Auto-Detect from Filenames" button in the manual batch modal to immediately pull true season and episode numbers directly from file names.
  - Increased episode numbering limit to 9999 to support long-running anime like *One Piece*.
  - Fixed `clean_detected_show_name` to preserve year-like numbers (1900-2099) in movie and series titles (e.g. *Blade Runner 2049*).
- **Manual Batch Sorting & Library Management**:
  - Added `POST /api/files/manual-sort-batch` and `POST /api/library/clear` endpoints.
  - Added floating multi-file selection bar and 2-step manual batch sorting overlay modal.

## [1.0.7] - 2026-09-05

### Added
- **Library Catalog & Show/Movie Management (`📚 Library`)**:
  - Added a dedicated top-level **📚 Library** view with full catalog tracking of all indexed shows and movies across storage drives.
  - Interactive selector buttons to switch between **📺 Shows**, **🎬 Movies**, and **📂 All**, with live count badges.
  - Real-time instant search input to filter titles as you type.
  - Disk scanning synchronization (`POST /api/library/rescan`) that indexes directory trees, episode counts, seasons, and technical metadata.
  - Persistent database tracking via `LibraryItem` table model with unique constraint protection and last-updated tracking.
- **Automatic Show Memory Routing**:
  - Whenever a new show is detected or sorted, it is automatically cataloged in the Library.
  - When inspecting downloads or analyzing files, media sorter queries known shows from the library and automatically routes incoming media (such as extras, behind-the-scenes, specials, and unbracketed files) into that show's folder (`SHOWS_DIR / <Show Name>`).
- **Unsure File Grouping Dropdowns**:
  - Automatically clusters non-show files into dedicated collapsible dropdown cards instead of dumping them into a flat singles list:
    - **Shared Subfolder Groups**: Files sharing a common subfolder in downloads form their own group card (e.g. `📁 Shared Subfolder: Dexter Extras (5 files)`).
    - **Matching Name Prefix Groups**: Files sharing a common clean title stem or prefix form their own group card (e.g. `🏷️ Matching Name Prefix: Blood, Guts and Body Parts (2 files)`).
    - Only truly lone, isolated files remain in the singles media list.
  - Group action buttons:
    - `⚡ Sort Group`: Sorts all files in the group directly via `POST /api/files/sort-group`.
    - `✏️ Set Show/Movie for Group`: Opens the manual assignment modal for the entire group, allowing one-click bulk categorization to Movies or TV Shows.
- **Group Sorting Endpoint (`POST /api/files/sort-group`)**:
  - Server endpoint that batch-processes unsure groups of files with show name override or movie destination formatting, atomic movement, and automatic library catalog registration.

### Fixed
- **Anime Fansub Adjacent Brackets Regex**:
  - Fixed `RE_ANIME_RELEASE` regex to support adjacent bracket tags without spaces (e.g. `[Erai-raws] Bleach - 001 [1080p][MultiSub][EF0AF7BA].mkv`), ensuring anime episode fan releases are accurately classified.
- **Prevent Anime Episode Matching into SxxExx**:
  - Added negative lookahead `(?![xX\w])` to prevent episodic titles like `Game of Thrones - 1x09 - Baelor` from prematurely matching `1` as an anime episode instead of `Season 1 Episode 9`.
- **Fast Local Artwork & Responsive Downloads Inspection**:
  - Updated `fetch_show_poster` with `allow_network=False` during folder inspection so downloads scanning completes in under 2 seconds rather than stalling on synchronous external network queries.

## [1.0.6] - 2026-09-05

### Added
- **Targeted Show Sorting (`POST /api/files/sort-show`)**:
  - The "⚡ Sort Now" button inside any show's dropdown card in the Downloads Folder Explorer now targets that specific show directly.
  - Sorts all episodes of that show into `SHOWS_DIR / <Show Name> / Season XX / ...` with full transaction tracking, database history, and instant rollback support.
  - Interactive UI with button loading spinner (`<span class="loading-spinner"></span> Sorting...`), disabled state during execution, success toast with count of sorted episodes, and automatic UI refresh.
- **Standalone Episode Pattern Recognition**:
  - Added support for standalone `Episode \d{1,4}` and `Ep \d{1,4}` patterns (e.g., `Naruto Episode 207 The Supposed Sealed Ability.mkv`, `Bleach Episode 05.mkv`).
  - Added support for anime/fansub series formatting without release group prefixes (e.g., `BLEACH꞉ Sennen Kessen-hen - 27 E89717B7].mkv`).
  - Added support for anime opening/ending patterns (`S03ED01`, `S03OP01`).
- **Interactive Button Loading States**:
  - Added loading spinner and disabled state to `⚡ Run Sort Now (Live)`, `⚡ Sort All Files`, and show-specific `⚡ Sort Now` buttons to prevent duplicate runs and give immediate visual feedback.

### Fixed
- **Show "Sort Now" Button Doing Nothing**:
  - Fixed issue where clicking "Sort Now" inside a show dropdown appeared to do nothing because episodic shows like Naruto were failing tokenizer matching, getting classified as low-confidence movies, and being quarantined (which were flagged but not moved).
  - Fixed button calling global sorting instead of targeted show sorting.
  - Fixed run results panel being hidden on Dashboard tab when viewing Folder Explorer tab.
- **MKV Video Containers Misclassified as Audio/Music**:
  - Fixed bug where video containers (`.mkv`, `.mp4`) containing audio streams were routed to audio-only classification if lightweight EBML header parsing didn't match a hardcoded video codec string.
  - Reordered classifier pipeline so video containers and extensions are always checked as videos first before audio-only handling.
  - Expanded EBML video track detection in `_parse_ebml` to recognize generic `V_` track headers (including VC-1, DivX, XviD, and MPEG2).

## [1.0.5] - 2026-09-05

### Added
- **Quarantine Top Action Buttons & Bulk Controls**:
  - Action buttons at the top of the Review & Quarantine header for immediate manual actions: `🎬 Move to Movies`, `📺 Move to Shows`, `✏️ Set Show/Movie`, `↩️ Unflag`, and `↩️ Undo All Resolved`.
  - Multi-item selection checkboxes with header `Select All` / `Deselect All` toggle and live selection count tracking.
  - Selection toolbar that adapts dynamically based on checked items for bulk execution.
  - Backend bulk endpoints:
    - `POST /api/quarantine/bulk-resolve`: Bulk moves selected or all pending quarantine items to Movies or TV Shows inside a fast transaction.
    - `POST /api/quarantine/bulk-undo`: Bulk unflags pending items or rollbacks all resolved quarantine files back to original source directories.
- **Manual Modal File Switcher**:
  - Added file picker dropdown inside `modal-manual-sort` when multiple quarantine items are available, enabling switching between items without reopening the modal.
- **Automatic Folder Explorer & Queue Refresh**:
  - Automatically re-scans and refreshes the Downloads Folder Explorer (`loadFiles`) and Quarantine queue (`loadQuarantine`) immediately whenever sorting runs (live or preview) or batch rollbacks complete.
- **Granular & Global Undo Actions**:
  - Added `↩️ Undo All Resolved` button to easily restore all resolved quarantine files to their source folders.
  - Per-item unflagging for pending items and per-item rollback for resolved items.

### Fixed
- **False-Positive TV Show Classifications for Movies**:
  - **Resolution Dimensions**: Filenames containing dimensions like `1920x1080` or `1280x720` no longer falsely match episodic TV season/episode regex (`20x108`, `80x720`). Added negative lookbehind/lookahead and resolution fallback parser `RE_DIMENSIONS`.
  - **Release Years in Torrent Tags**: Anime release regex pattern no longer treats 4-digit release years (1900–2099) in bracketed torrent tags (e.g., `[YTS.MX] Movie Title - 2024 [1080p].mkv`) as episode numbers.
  - **Broad Substring Match**: Replaced broad `"tv" in path_str` check with directory boundary regex `(?i)[/\\](?:tv[/\\]|tv[-_\s]shows?|tv[-_\s]series|season[-_\s]*\d+)`, preventing movies with `HDTV`, `[rartv]`, or `Apple.TV` from routing to TV show logic.
  - **Folder Explorer Subdirectories**: Fixed downloads inspector so scene/torrent movie subfolders (e.g. `The.Dark.Knight.2008.1080p.BluRay/`) are not misidentified as TV show names; movies now properly appear under `singles` targeting `MOVIES_DIR`.
  - **Release Group Cleaning**: Updated `_clean_title` to cleanly strip leading bracketed group tags (e.g., `[YTS.MX]`, `[rarbg]`, `[TGx]`).
- **`.txt` Companion Cleaning & Explorer Filter**:
  - Excluded `.txt` companions (e.g., torrent notes, RARBG.txt) from the folder explorer.
  - Automatically cleans up companion `.txt` files and empty parent release folders when media files are deleted or organized.
- **Safe Quarantine Mode**:
  - Flagged files with confidence below threshold remain in place safely rather than being automatically moved.
- **Missing Module Import**:
  - Fixed missing `import re` in `src/media_sorter/classifier.py`.

### Changed
- Unified Settings and `.env` configuration into a single coherent dashboard tab.
- Expanded automated test suite to 65 tests covering movie dimension tokenization, bracketed release years, HDTV classification, folder explorer movie detection, and bulk quarantine APIs.

---

## [1.0.4] - 2026-09-05

### Added
- File renaming toggle (`RENAME_FILES`) and customizable naming templates for movies and TV shows (`MOVIE_TEMPLATE`, `TV_TEMPLATE`).
- Automatic cleanup of empty parent directories after files are moved (`CLEANUP_EMPTY_DIRS`).

---

## [1.0.3] - 2026-09-05

### Added
- TV show dropdown aggregation in downloads folder explorer with collapsible season groups.
- Local artwork and TVmaze poster lookup for series.

---

## [1.0.2] - 2026-09-05

### Added
- Instant batch rollbacks and transactional operation journaling.
- Manual file categorization modal and REST API endpoints.

---

## [1.0.1] - 2026-09-05

### Added
- Multi-signal classifier supporting audiobooks, podcasts, home videos, and archives.
- SQLite WAL operation journaling.

---

## [1.0.0] - 2026-09-05

### Added
- Initial release with atomic file sorting, dry-run simulation, and web dashboard.
## [1.0.8] - 2026-09-06

### Added
- Added missing custom themes: neon-forest, retro-retro, golden-sand, deep-space, candy-cotton.
- Implemented RGB Chroma mode UI with toggle and speed slider, keyframe animations, and persistence via localStorage.
- Added unit tests for theme availability and RGB feature.
## [1.0.9] - 2026-09-06

### Added
- Implemented `.rgb-mode` CSS class with keyframe animation for chroma glow.
- Updated project version to 1.0.9 across metadata.

### Fixed
- RGB visual effect was missing, now correctly applied.
- Version numbers were out‑of‑sync between `pyproject.toml` and package `__init__`.


## [1.0.10] - 2026-09-06

### Added
- Updated README with section on using the Antigravity bot via Direct Messages.
- Added no‑cache HTTP headers to ensure version badge updates reliably.

### Changed
- Bumped project version to 1.0.10 in `pyproject.toml` and package `__init__`.

### Fixed
- Version numbers now stay in sync across metadata files.