nfoguard/SUMMARY.md

NFOGuard Development Summary

Current Status: v1.4.6 - Flexible Debug Controls! �️

Latest Updates (v1.4.6)

• 🎛️ FLEXIBLE DEBUGGING: Added PATH_DEBUG environment variable for path mapping debug control
• 🧹 PRODUCTION READY: Can now disable path debug while keeping general logging
• ⚙️ GRANULAR CONTROL: Separate debug controls for different system components
• ✅ CONFIGURABLE: Debug output now completely controllable via .env settings

New Debug Control System

# General application debugging (webhooks, processing, etc.)
DEBUG=true

# Path mapping debugging (verbose path translation output)  
PATH_DEBUG=false

Debug Output Examples

With PATH_DEBUG=false (Production):

INFO: Received Radarr webhook: Download
INFO: Batched movie webhook for movie:tt3322940
INFO: Processing movie: Annabelle (2014) [tt3322940]
INFO: Completed processing movie: Annabelle (2014) [tt3322940]

With PATH_DEBUG=true (Troubleshooting):

PATH_DEBUG: PathMapper initialized with:
PATH_DEBUG: radarr_roots: ['/mnt/unionfs/Media/Movies/movies', '/mnt/unionfs/Media/Movies/movies6']
PATH_DEBUG: radarr_path_to_container_path input: /mnt/unionfs/Media/Movies/movies6/Annabelle...
PATH_DEBUG: Checking radarr_root[1]: /mnt/unionfs/Media/Movies/movies6
PATH_DEBUG: Match found! Index 1
PATH_DEBUG: Mapped to: /media/Movies/movies6/Annabelle (2014) [tt3322940]

Recommended Production Settings

# Optimal for production monitoring:
DEBUG=true          # Keep application logging for monitoring
PATH_DEBUG=false    # Disable verbose path mapping output

# Minimal logging for high-performance:
DEBUG=false         # Disable all debug output
PATH_DEBUG=false    # Disable path mapping debug

Debug Scenarios

• ✅ Production: DEBUG=true, PATH_DEBUG=false - Monitor without noise
• 🔧 Troubleshooting: DEBUG=true, PATH_DEBUG=true - Full diagnostics
• 🚀 High Performance: DEBUG=false, PATH_DEBUG=false - Minimal logging
• 🎯 Path Issues: DEBUG=false, PATH_DEBUG=true - Focus on path mapping only

🎛️ NFOGuard now offers complete control over debug output levels! 🎛️