nfoguard/NFOGuard.Emby.Plugin/README.md

NFOGuard Emby Plugin

This is the companion Emby plugin for NFOGuard that automatically synchronizes TV episode PremiereDate to DateCreated to preserve import dates.

Features

• Real-time processing of new and updated TV episodes
• Automatically syncs PremiereDate → DateCreated when episodes are added/scanned
• Preserves original import dates from NFO files
• Logging for debugging and monitoring

Installation

1. Build the plugin DLL
2. Copy to Emby's plugins directory
3. Restart Emby server
4. Plugin will automatically start processing episodes

How It Works

The plugin hooks into Emby's library events (ItemAdded/ItemUpdated) and:

1. Detects when TV episodes are processed
2. Checks if PremiereDate exists and differs from DateCreated
3. Updates DateCreated to match PremiereDate
4. Saves changes to the Emby database

This ensures that Emby displays the correct import date (from NFO dateadded) instead of the scan date.