dll integration

2025-09-12 09:04:23 -04:00
parent dcbb25ca9e
commit 08cddf7799
57 changed files with 3293 additions and 1 deletions
@@ -0,0 +1,70 @@
+# NFOGuard Emby Plugin Deployment Guide
+
+## Prerequisites
+
+- .NET Framework 4.8 SDK or Visual Studio Build Tools
+- Emby Server 4.7+ running
+- Access to Emby's plugins directory
+
+## Building the Plugin
+
+### Windows
+```cmd
+build.bat
+```
+
+### Linux/macOS
+```bash
+./build.sh
+```
+
+## Installation Steps
+
+1. **Build the plugin** using the build script above
+2. **Locate your Emby plugins directory:**
+   - Windows: `C:\ProgramData\Emby-Server\plugins`
+   - Linux: `/var/lib/emby/plugins`
+   - Docker: `/config/plugins` (inside container)
+   - Synology: `/volume1/Emby/plugins`
+
+3. **Copy the DLL:**
+   ```bash
+   cp bin/Release/NFOGuard.Emby.Plugin.dll /path/to/emby/plugins/
+   ```
+
+4. **Restart Emby Server**
+
+5. **Verify installation:**
+   - Check Emby dashboard → Plugins
+   - Look for "NFOGuard" in the installed plugins list
+   - Check Emby logs for "NFOGuard :: Plugin starting up"
+
+## Testing
+
+1. **Add a new TV episode** to your library with an NFO file containing `<dateadded>`
+2. **Check the logs** for NFOGuard processing messages:
+   ```
+   NFOGuard :: Processing Added Episode :: Episode Name
+   NFOGuard :: Syncing PremiereDate to DateCreated :: Episode Name
+   NFOGuard :: Successfully updated :: Episode Name
+   ```
+3. **Verify in database:**
+   ```sql
+   sqlite3 library.db2 "SELECT DateCreated, PremiereDate FROM MediaItems WHERE Name LIKE '%episode%';"
+   ```
+
+## Troubleshooting
+
+- **Plugin not appearing:** Check Emby logs for loading errors
+- **Not processing episodes:** Verify log level includes Info messages
+- **Build failures:** Ensure all Emby SDK DLLs are in EmbySDK folder
+- **Permission errors:** Ensure Emby service has write access to database
+
+## SDK Dependencies
+
+The plugin requires these Emby SDK DLLs in the `EmbySDK` folder:
+- MediaBrowser.Common.dll
+- MediaBrowser.Controller.dll  
+- MediaBrowser.Model.dll
+
+These can be extracted from your Emby Server installation directory.