Complete TV webhook processing modes documentation update

📚 Comprehensive Documentation Update:
• Added TV webhook processing modes section to README.md
• Updated CHANGELOG.md with configurable processing feature details
• Enhanced SETUP.md with TV_WEBHOOK_PROCESSING_MODE configuration
• Added Step 7 testing procedures to TESTING.md for both modes

🔧 Configuration Documentation:
• Targeted Mode (default): Only process episodes mentioned in webhook
• Series Mode: Process entire series directory (legacy behavior)
• Smart fallback logic when episode data unavailable
• Clear examples and use case recommendations

📋 Testing Instructions:
• Step-by-step mode switching procedures
• Expected log output examples for each mode
• Environment variable configuration examples
• Docker restart procedures for testing

 User Benefits Documented:
• Efficiency comparison: targeted vs series processing
• File operation reduction for targeted mode
• Media server notification minimization
• Backward compatibility with existing setups
This commit is contained in:
2025-09-11 11:26:39 -04:00
parent ac2753509d
commit 86d2cee1f9
4 changed files with 68 additions and 0 deletions
+5
View File
@@ -25,6 +25,11 @@ All notable changes to this project will be documented in this file.
- **Season Detection**: `curl -X POST "manual/scan?path=/media/TV/Series/Season 13"`
- **Episode Detection**: `curl -X POST "manual/scan?path=/media/TV/Series/Season 13/episode.mkv"`
- **Automatic Processing**: Detects context and processes accordingly
- **⚙️ Configurable TV Webhook Processing**: Choose between targeted or comprehensive processing
- **Targeted Mode**: `TV_WEBHOOK_PROCESSING_MODE=targeted` (default) - Only process webhook episodes
- **Series Mode**: `TV_WEBHOOK_PROCESSING_MODE=series` - Process entire series directory
- **Smart Fallback**: Automatically falls back to series mode when episode data unavailable
- **Efficiency**: Targeted mode reduces unnecessary file operations and notifications
- **🔐 Secure Configuration System**: Two-file configuration with automatic API key masking
- **Main `.env`**: Paths and preferences (safe to share for debugging)
- **Separate `.env.secrets`**: API keys and passwords (never committed to git)