nfoguard/SUMMARY.md

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:

# 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

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