initial comment

SCAN-ALL-FILES-CHANGE.md

@@ -0,0 +1,128 @@
+# Scan All Files - Workflow Change
+
+## What Changed
+
+The library scanner now finds **ALL video files** in your collection, regardless of whether they have subtitles or not.
+
+### Before
+- Scanner only marked files with subtitles as "discovered"
+- Files without subtitles were marked as "skipped"
+- You could only encode files that had subtitles
+
+### After
+- Scanner marks **ALL files** as "discovered"
+- Use dashboard filters to find files you want to encode
+- Much more flexible workflow
+
+## Why This Change?
+
+The previous workflow was too restrictive. You might want to encode files for reasons other than removing subtitles:
+- Convert H.264 to H.265 for better compression
+- Re-encode large files to save space
+- Upgrade to 4K or different resolution
+- Convert to different codec for compatibility
+- Reduce bitrate for streaming
+
+The filter system now lets you find files based on what matters to you.
+
+## New Workflow
+
+### 1. Scan Your Entire Library
+Click **"📂 Scan Library"** - finds ALL video files
+
+### 2. Use Filters to Find What You Want
+Examples:
+- **"🎞️ H.264"** - Find all H.264 videos to convert to H.265
+- **"💾 Large Files (>5GB)"** - Find large files to compress
+- **"📝 Has Subtitles"** - Find files with subtitles to remove
+- **"❌ No Subtitles"** - Find files without subtitles
+- **"🔊 5.1+ Audio"** - Find surround sound content
+- **"📺 4K"** - Find 4K content
+
+### 3. Select and Encode
+- Use checkboxes to select specific files
+- Or click **"📁 Discovered"** to select all filtered results
+- Choose encoding profile
+- Click **"▶️ Encode Selected"**
+
+## Configuration Change
+
+The `skip_without_subtitles` config option is now **deprecated**:
+
+```yaml
+processing:
+  # Deprecated - all files are now scanned
+  skip_without_subtitles: false
+```
+
+This setting is kept for backward compatibility but no longer has any effect.
+
+## Files Modified
+
+### reencode.py (Line 394)
+Changed from:
+```python
+state = ProcessingState.DISCOVERED.value if has_subtitles else ProcessingState.SKIPPED.value
+```
+
+To:
+```python
+state = ProcessingState.DISCOVERED.value  # All files marked as discovered
+```
+
+### Config Files
+Updated comments in:
+- `config.yaml`
+- `config-intel.yaml`
+- `config-nvidia.yaml`
+- `config-cpu.yaml`
+
+## Example Use Cases
+
+### Convert Entire Library to H.265
+1. Scan library (finds all files)
+2. Click **"🎞️ H.264"** filter
+3. Click **"📁 Discovered"** to select all H.264 files
+4. Choose `sweetspot_qsv` or `sweetspot_gpu` profile
+5. Encode!
+
+### Process Only Large Files
+1. Scan library
+2. Click **"💾 Large Files (>5GB)"**
+3. Select files you want to compress
+4. Encode with quality profile
+
+### Remove Subtitles from Specific Movies
+1. Scan library
+2. Click **"📝 Has Subtitles"**
+3. Use search to find specific titles
+4. Select and encode
+
+### Find 4K Content
+1. Scan library
+2. Click **"📺 4K"**
+3. See all your 4K movies
+4. Optionally re-encode with 4K-optimized profile
+
+## Benefits
+
+✅ **More Flexible** - Find files based on ANY attribute, not just subtitles
+✅ **Better Control** - See your entire library, decide what to process
+✅ **Multiple Workflows** - Compress, convert, upgrade, or optimize
+✅ **Filter Combinations** - Combine state + attribute filters
+✅ **Search + Filter** - Use search with filters for precise selection
+
+## Migration
+
+No action needed! The change is automatic:
+- Existing "skipped" files will remain skipped
+- New scans will mark everything as "discovered"
+- You can rescan to update old files to "discovered" state
+
+## Testing
+
+After deploying:
+1. Click **"📂 Scan Library"**
+2. Should see ALL video files marked as "discovered"
+3. Try different filters to narrow down selection
+4. Select and encode as usual