Tagger/CHANGELOG.md

# Changelog

All notable changes to the Tagger project are documented in this file.

## [1.2.0] - 2026-04-09

### Added
- **Undo/redo** - `Ctrl+Z` / `Ctrl+Y` vrátí/zopakuje tag operace (assign, remove, rename, merge)
  - Zásobník 50 kroků, čistí se při zavření složky
  - Edit menu zobrazuje popis poslední operace
  - Pokrývá: přiřazení tagu, odebrání tagu, přejmenování tagu/kategorie, sloučení tagu/kategorie
- **CSFD cache** - Movie data cached in `.!tag` after first fetch, no re-fetching on reopen
  - `CSFDMovie.to_dict()` / `from_dict()` for serialization
  - `File.get_cached_movie()` - returns cached data without network access
  - Cache versioning (`CSFD_CACHE_VERSION`) for future schema invalidation
  - Cache invalidated automatically when CSFD URL changes
- **Orphaned sidecar detection** - On folder scan, `.!tag` files without a matching media file are reported
  - `FileManager.on_orphaned_tags` callback for UI notification
  - `FileManager.find_orphaned_tags()` for manual scan
- **OR/NOT tag filtering** - Extended `filter_files_by_tags()` with new parameters
  - `any_of` - file must have at least one of these tags (OR)
  - `must_not` - file must not have any of these tags (NOT)
  - Fully backward compatible
- **ffprobe threading** - Video resolution detection now runs in background (`VideoResolutionWorker`)
  - Status bar shows live progress: `Zjišťuji rozlišení (3/12)…`
  - Menu action disabled during processing
- **Export to CSV** - Soubor → "Exportovat do CSV..."
  - UTF-8 BOM encoding (Excel compatible)
  - Columns: filename, path, date, tags, CSFD URL, size
- **Drag & drop** - Drag folder or file onto the app window to open it

### Changed
- **Global config location** - Moved from app directory to `~/.config/Tagger/`
  - Automatic one-time migration from old location
  - Fixes crash on read-only PyInstaller build directories
- **Python version** - Bumped to 3.14+

### Dependencies
- Removed: Pillow (unused)
- Moved: python-dotenv from dev to runtime dependencies

### Tests
- 274 tests (all passing)

## [1.1.0] - 2026-01-23

### Changed
- **GUI rewrite to PySide6/Qt6** - Complete UI rewrite from Tkinter to Qt
  - Modern QMainWindow with menu bar, toolbar, and status bar
  - QTreeWidget for tag sidebar with category colors
  - QTableWidget for file list with sorting and filtering
  - QSplitter for resizable sidebar
  - Native Qt dialogs (QFileDialog, QInputDialog, QMessageBox)
  - Keyboard shortcuts using QShortcut
  - Window geometry persistence
- **UI utilities updated** - `src/ui/utils.py` now uses Qt (QIcon, QPixmap)
- **Python version restricted** - Requires Python >=3.13,<3.15 for PySide6 compatibility

### Dependencies
- Added PySide6 (>=6.10.1)
- Removed Tkinter dependency

## [1.0.5] - 2026-01-23

### Added
- **Tag and category renaming** - New context menu functionality
  - Right-click on tag → "Rename tag"
  - Automatic update of all files with the tag
  - Support for renaming entire categories
- **Tag merging** - When renaming to an existing tag
  - Confirmation dialog for merge
  - Merge removes source tag and updates files
- **Tag.from_string()** - New class method for parsing tags
  - Parses "category/name" format
  - Eliminates duplicate code across the project
- **Dynamic version loading** - Version is loaded from pyproject.toml
  - Fallback to `_version.py` if toml is not available
  - DEBUG mode support from `.env` (adds " DEV" suffix)
  - APP_NAME includes version: "Tagger v1.0.5 DEV"
- **UI utilities module** - `src/ui/utils.py`
  - Moved `load_icon()` function from core to UI layer

### Changed
- **FileManager refactoring**
  - New methods `assign_tag_to_files()` and `remove_tag_from_files()`
  - Old methods kept as deprecated aliases
  - `Tag` import at module level (eliminates duplicate imports)
- **Dead code removal**
  - Deleted unused `ListManager` module
  - Removed legacy functions `load_config()` and `save_config()` from config.py
- **Missing import fix** - Added `import subprocess` to media_utils.py

### Tests
- 274 tests (all passing)
- New tests for Tag.from_string() (6 tests)
- New tests for rename/merge tags (24 tests)

## [1.0.4] - 2025-12-29

### Added
- **CSFD.cz integration** - Fetching movie information
  - `fetch_movie()` - load movie details from URL
  - `search_movies()` - search for movies
  - Automatic tag assignment (genres, year, country, director)
- **Close folder** - Safe folder closing with metadata saving

### Tests
- 249 tests covering CSFD integration

## [1.0.3] - 2025-12-28

### Added
- **Hardlink structure** - New functionality for creating directory structure using hardlinks
  - `HardlinkManager` class in `src/core/hardlink_manager.py`
  - Creating hardlinks based on file tags (e.g., `output/genre/Comedy/movie.mkv`)
  - Structure synchronization - detection and removal of outdated hardlinks when tags change
  - Support for filtering by categories
  - Preview mode (dry run)
- **Menu items for hardlinks**
  - "Set hardlink folder..." - configure output folder and categories (saved to `.tagger.json`)
  - "Update hardlink structure" - quick sync with saved settings
  - "Create hardlink structure..." - manual folder and category selection
- **Three-level configuration system**
  - Global config (`config.json`) - application settings (window geometry, last folder)
  - Folder config (`.tagger.json`) - project settings (ignore patterns, hardlink settings)
  - File tags (`.filename.!tag`) - individual file metadata
- **Default tags**
  - "Rating" category with stars (1-5 stars)
  - "Color" category with color labels
  - Exclusive selection in Rating category (only one tag)
- **Tests**
  - 189 tests covering all modules
  - Tests for hardlink manager including synchronization
- **Poetry** - Dependency management using Poetry

### Changed
- Modernized GUI inspired by qBittorrent
- Window geometry saved to global config
- Ignore patterns saved to folder config

## [1.0.2] - 2025-10-03

### Added
- **Modern GUI** - Redesigned interface in qBittorrent style
  - Side panel with categories and tags
  - File table with column sorting
  - Context menus for files and tags
  - Search field
  - Status bar with file count and selection size
- **Bulk tag assignment** - Dialog for assigning tags to multiple files at once
  - Tri-state checkboxes (checked/unchecked/mixed)
  - Color-coded categories
- **Video resolution detection** - Automatic detection using ffprobe
- **Keyboard shortcuts**
  - Ctrl+O - Open folder
  - Ctrl+T - Assign tags
  - Ctrl+D - Set date
  - F5 - Refresh
  - Delete - Remove from index

### Changed
- Project structure refactored into modules (`src/core/`, `src/ui/`)
- Using dataclass for Tag and File objects

## [1.0.0] - 2025-09-03

### Added
- Basic file tagging functionality
- Storing tags in hidden files (`.filename.!tag`)
- Category and tag management
- Recursive folder scanning
- Ignore patterns for file filtering
- Basic GUI in Tkinter