70 lines
1.9 KiB
Markdown
70 lines
1.9 KiB
Markdown
# 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. |