sbcrumb
ed4a9c0a19
- Add event type filtering to Radarr webhook handler (Download, Upgrade, Rename) - Ensures consistency with Sonarr webhook processing - Fixes issue where Radarr rename events weren't properly updating NFO files - Bump version to v1.5.3 - Update SUMMARY.md with complete webhook workflow documentation
120 lines
5.0 KiB
Markdown
120 lines
5.0 KiB
Markdown
# NFOGuard Development Summary
|
|
|
|
## Current Status: v1.5.3 - Radarr Rename Event Fix! 🔧
|
|
|
|
### Latest Updates (v1.5.3) - September 15, 2025
|
|
- **🔧 RADARR RENAME FIX**: Added missing event type filtering to Radarr webhooks
|
|
- **✅ CONSISTENCY**: Radarr now matches Sonarr's event handling (Download, Upgrade, Rename)
|
|
- **🎯 FIXED ISSUE**: Radarr rename events now properly trigger NFO updates with correct dates
|
|
- **🔄 WORKFLOW**: Both Sonarr and Radarr now follow identical webhook processing flows
|
|
|
|
### Previous Updates (v1.5.2)
|
|
- **🔇 TVDB WARNINGS**: Added SUPPRESS_TVDB_WARNINGS configuration option
|
|
- **✅ CLEAN LOGS**: Can now suppress non-critical TVDB API failure warnings
|
|
- **🧹 PRODUCTION**: Cleaner logs for production monitoring
|
|
- **🎯 FUNCTIONAL**: System works perfectly without TVDB (uses IMDb/Sonarr data)
|
|
|
|
### TVDB Warning Suppression
|
|
**Added new environment variable:**
|
|
```bash
|
|
# Suppress TVDB API warnings (true/false) - TVDB failures are common and non-critical
|
|
SUPPRESS_TVDB_WARNINGS=true
|
|
```
|
|
|
|
### Why Suppress TVDB Warnings?
|
|
- **❌ Common Failures**: Many series don't exist in TVDB database
|
|
- **✅ Non-Critical**: NFOGuard works perfectly without TVDB data
|
|
- **📊 Primary Data**: Uses IMDb IDs and Sonarr metadata (more reliable)
|
|
- **🧹 Log Noise**: Reduces repetitive warning messages
|
|
|
|
### Before vs After
|
|
|
|
**Before (noisy):**
|
|
```
|
|
INFO: All episodes found in cache
|
|
WARNING: GET https://api4.thetvdb.com/v4/search/remoteid?remoteId=tt0804484&type=series failed: HTTP Error 400: Bad Request
|
|
INFO: Completed processing TV series: Foundation (2021) [imdb-tt0804484]
|
|
WARNING: GET https://api4.thetvdb.com/v4/search/remoteid?remoteId=tt9737326&type=series failed: HTTP Error 400: Bad Request
|
|
```
|
|
|
|
**After (clean):**
|
|
```
|
|
INFO: All episodes found in cache
|
|
INFO: Completed processing TV series: Foundation (2021) [imdb-tt0804484]
|
|
INFO: Completed processing TV series: Invasion (2021) [imdb-tt9737326]
|
|
```
|
|
|
|
### Your Configuration
|
|
```bash
|
|
DEBUG=false # Clean production logging
|
|
PATH_DEBUG=false # No path mapping debug
|
|
SUPPRESS_TVDB_WARNINGS=true # Hide non-critical TVDB failures
|
|
```
|
|
|
|
### System Status
|
|
- ✅ **Processing**: All TV series processing successfully
|
|
- ✅ **Episodes**: All episodes found and processed
|
|
- ✅ **NFO Files**: Being created/updated with proper metadata
|
|
- ✅ **Functionality**: TVDB failures don't affect operation
|
|
|
|
## 🔇 NFOGuard v1.5.2 - Ultra-clean production logs! 🔇
|
|
|
|
### Copy SUPPRESS_TVDB_WARNINGS=true to your server .env file and restart!
|
|
|
|
---
|
|
|
|
## 🔧 FIXED: Radarr Rename Event Issue (September 15, 2025)
|
|
|
|
### Issue Resolution
|
|
**COMPLETED**: Fixed missing Radarr rename event handling by adding proper event type filtering.
|
|
|
|
### ✅ **Both Sonarr & Radarr Webhook Handling** - **NOW WORKING CORRECTLY**
|
|
- **Sonarr Location**: `nfoguard.py:1429`
|
|
- **Radarr Location**: `nfoguard.py:1479` **(FIXED)**
|
|
- **Event Filtering**: `if event_type not in ["Download", "Upgrade", "Rename"]:`
|
|
- **✅ STATUS**: **Rename events ARE processed for both systems**
|
|
- **✅ BEHAVIOR**: Both systems now update NFO files with proper date metadata on rename
|
|
|
|
### What Was Fixed
|
|
1. **Added Event Type Filtering**: Radarr webhooks now explicitly filter for supported events
|
|
2. **Consistent Processing**: Both Sonarr and Radarr now follow identical webhook workflows
|
|
3. **Proper Rename Handling**: Rename events trigger full NFO processing pipeline
|
|
|
|
---
|
|
|
|
## 📋 NFOGuard Webhook Workflow Documentation
|
|
|
|
### 🎬 **Radarr Webhook Workflow**
|
|
1. **Import Event**:
|
|
- Check database - if not seen before, current timestamp = truth of first import
|
|
- Update movie.nfo with proper date metadata
|
|
|
|
2. **Rename Event**:
|
|
- Check database - if we have the date, use existing date
|
|
- Update movie.nfo file as always (preserving original import date)
|
|
|
|
3. **Rename Event (No Database Entry)**:
|
|
- Check Radarr database for earliest import date
|
|
- If found, use earliest import date → update database + movie.nfo
|
|
- If no import date found, use digital/theatrical release date (fallback logic)
|
|
|
|
### 📺 **Sonarr Webhook Workflow**
|
|
1. **Import Event**:
|
|
- Check database - if not seen before, current timestamp = truth of first import
|
|
- Update episode.nfo with proper date metadata
|
|
|
|
2. **Rename Event**:
|
|
- Check database - if we have the date, use existing date
|
|
- Update episode.nfo file as always (preserving original import date)
|
|
|
|
3. **Rename Event (No Database Entry)**:
|
|
- Check Sonarr API for earliest import date
|
|
- If found, use earliest import date → update database + episode.nfo
|
|
- If no import date found, use air date (fallback logic)
|
|
|
|
### 🔄 **Key Processing Logic**
|
|
- **Database First**: Always check NFOGuard database for existing dates
|
|
- **Import Truth**: Webhook import events establish "source of truth" timestamps
|
|
- **Date Preservation**: Rename events preserve original import dates, never overwrite
|
|
- **Smart Fallbacks**: API queries → Release dates → Air dates → File dates (configurable)
|
|
- **Batch Processing**: All webhooks go through batching system with configurable delays |