nfoguard/SUMMARY.md

NFOGuard Development Summary

Current Status: v1.4.1 - Complete TV & Movie NFO Management

Latest Updates (v1.4.1)

• 📺 TV SHOW SUPPORT: Extended preservation logic to tvshow.nfo, season.nfo, and episode.nfo
• 🎯 CONSISTENT BEHAVIOR: All NFO types now preserve existing content and append NFOGuard fields
• ✅ COMPREHENSIVE: Movies, TV shows, seasons, and episodes all handle field placement correctly
• 🧹 UNIFIED APPROACH: Same preservation and bottom-placement logic across all media types

Complete NFO Management Coverage

Movie NFO Structure

<movie>
  <!-- All existing Radarr content preserved -->
  <title>Movie Title</title>
  <plot>Plot...</plot>
  <actor>...</actor>
  
  <!-- NFOGuard fields at bottom -->
  <uniqueid type="imdb" default="true">tt8350360</uniqueid>
  <premiered>2019-06-26</premiered>
  <year>2019</year>
  <dateadded>2025-09-14T13:50:34-04:00</dateadded>
  <lockdata>true</lockdata>
</movie>

TV Show NFO Structure

<tvshow>
  <!-- All existing Sonarr content preserved -->
  <title>Show Title</title>
  <plot>Show plot...</plot>
  <actor>...</actor>
  
  <!-- NFOGuard fields at bottom -->
  <uniqueid type="imdb" default="true">tt1234567</uniqueid>
  <uniqueid type="tvdb">12345</uniqueid>
  <lockdata>true</lockdata>
</tvshow>

Episode NFO Structure

<episodedetails>
  <!-- All existing Sonarr content preserved -->
  <title>Episode Title</title>
  <plot>Episode plot...</plot>
  <director>...</director>
  
  <!-- NFOGuard fields at bottom -->
  <season>1</season>
  <episode>5</episode>
  <aired>2019-06-26</aired>
  <dateadded>2025-09-14T13:50:34-04:00</dateadded>
  <lockdata>true</lockdata>
</episodedetails>

Preservation Features

• ✅ Movies: Preserves title, plot, actors, ratings, all existing metadata
• ✅ TV Shows: Preserves show metadata, existing uniqueid[tvdb], actor info
• ✅ Episodes: Preserves episode title, plot, director, existing aired dates
• ✅ Seasons: Preserves any existing season metadata
• ✅ All Types: Existing content stays in original order, NFOGuard fields at bottom

Complete Path Processing Pipeline

• ✅ Path Mapping: Fixed substring matching (movies/movies6, tv/tv6)
• ✅ Database Schema: Clean migration with all required columns
• ✅ NFO Preservation: Existing metadata maintained with fields appended
• ✅ Webhook Processing: End-to-end processing working correctly