sbcrumb/nfoguard
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update to docker

Browse Source
This commit is contained in:
SBCrumb
2025-09-17 15:23:29 -04:00
parent d64228cc82
commit 532ea02a5b
4 changed files with 103 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Project.md
+36 -7
View File
@@ -1,5 +1,27 @@
# NFOGuard Project Overview
## 🎯 Three-Component System Architecture
**NFOGuard** is a comprehensive media date management ecosystem consisting of three integrated repositories:
### 1. **NFOGuard (Docker Service)** [THIS REPOSITORY]
- **Purpose**: Main webhook service that listens for Sonarr/Radarr events and manages NFO files
- **Version**: v1.6.0
- **Technology**: Python 3, Docker, PostgreSQL integration
- **Role**: Records import dates, creates/updates NFO files, manages filesystem timestamps
### 2. **NFOGuard-Emby-Plugin** (Companion DLL)
- **Purpose**: Emby Server plugin that reads NFO dateadded values and syncs to Emby's DateCreated field
- **Version**: v0.6.1
- **Technology**: C# .NET Framework 4.8, Emby SDK
- **Role**: Real-time date synchronization within Emby, license validation
### 3. **nfoguard-license-server** (License Management)
- **Purpose**: License validation server with admin interface for plugin access control
- **Version**: v1.3.1
- **Technology**: Node.js, Express, SQLite
- **Role**: 7-day trials, license validation, user management dashboard
## Project Purpose
NFOGuard is an automated NFO file management system that integrates with Radarr and Sonarr to maintain accurate metadata and release dates in media library NFO files. It serves as a webhook-driven middleware that preserves existing metadata while adding clean, standardized date information.
@@ -302,7 +324,7 @@ NFOGuard is an automated NFO file management system that integrates with Radarr
### When Starting a New Session
1. **Read Project.md** - This file for full context
2. **Check SUMMARY.md** - Latest changes and current version
3. **Review VERSION** - Current version number
3. **Review VERSION** - Current version number (v1.6.0)
4. **Key Files to Understand**:
- `nfoguard.py` - Main logic, webhook handlers
- `core/nfo_manager.py` - NFO creation, parsing, renaming
@@ -315,17 +337,24 @@ NFOGuard is an automated NFO file management system that integrates with Radarr
- **NFO Renaming**: `core/nfo_manager.py:336-491` (smart episode renaming)
- **Dual Identification**: `core/nfo_manager.py:85-149` (directory + NFO parsing)
### User Context
- **User has**: Radarr, Sonarr, Unmanic integration
- **Environment**: Docker deployment, PostgreSQL databases
- **Focus Areas**: Webhook accuracy, NFO standardization, date integrity
### Project Context (Updated 2025-09-17)
- **Current Status**: Production-ready system with 3-component architecture
- **Version**: v1.6.0 (NFOGuard Docker), v1.1.18 (Emby Plugin), v1.3.2 (License Server)
- **User Environment**: Docker deployment, PostgreSQL databases, Unmanic integration
- **Focus Areas**: Webhook accuracy, NFO standardization, date integrity, lifetime license management
- **Testing Method**: Real webhooks from Radarr/Sonarr, manual scans for validation
- **Recent Updates**: Fixed lifetime license display issue with explicit "never" expires handling
### Three-Repository System Overview
1. **NFOGuard (Docker)** - Main webhook service and NFO management
2. **NFOGuard-Emby-Plugin** - DLL for real-time Emby date synchronization
3. **nfoguard-license-server** - License validation and user management
### Recent Work Pattern
- User reports issues with specific examples (log snippets, webhook behavior)
- We debug by analyzing code at specific line numbers
- Implement fixes with proper error handling and logging
- Update documentation (SUMMARY.md, README.md, Project.md)
- Update documentation (SUMMARY.md, README.md, Project.md) across all repositories
- Version bump and prepare for deployment
This project represents a mature, production-ready system for automated NFO management with comprehensive webhook integration and intelligent metadata handling.
This project represents a mature, production-ready system for automated NFO management with comprehensive webhook integration, intelligent metadata handling, and integrated license management.