How kometa-team/kometa works
Main Components
a. Core Components:
• Configuration Management System
• Media Library Manager
• Metadata Processing Engine
• Collection Builder System
• Overlay Management System
• Cache System
• API Integration Hub
b. External Integrations:
• Media Servers (Plex)
• Media Management Tools (Sonarr, Radarr)
• Metadata Sources (TMDb, IMDb, Trakt, etc.)
• Notification Services (Webhooks, Gotify)
• Authentication Systems
┌─ User Interface Layer ─────────────────────┐
• Configuration Files │
• Command Line Interface │
• ┬───────────────────────┘
• ↓
┌─ Core Processing Layer ───────────────────┐
• ┌─────────────┐ ┌──────────┐ ┌───────┐ │
• Config │ │ Library │ │ Cache │ │
• Manager │←→│ Manager │←→│ System│ │
• ┘ └──────────┘ └───────┘ │
• ↕ ↕ ↕ │
• ┌─────────────┐ ┌──────────┐ ┌───────┐ │
• Collection │ │ Metadata │ │Overlay│ │
• Builder │←→│ Processor│←→│Manager│ │
• ┘ └──────────┘ └───────┘ │
• ┬───────────────────────┘
• ↓
┌─ Integration Layer ────────────────────────┐
• ┌─────────┐ ┌────────┐ ┌───────────────┐ │
• Media │ │ Media │ │ Metadata │ │
• Servers │ │ Mgmt │ │ Sources │ │
• ┘ └────────┘ └───────────────┘ │
• ┌─────────────────┐ ┌─────────────────┐ │
• Notification │ │ Authentication │ │
• Services │ │ Services │ │
• ┘ └─────────────────┘ │
• ┘
Key Relationships to Highlight
• Bidirectional data flow between the Library Manager and external media servers
• Configuration Manager's control over all components
• Cache System's interaction with metadata sources
• Collection Builder's dependency on metadata sources
• Overlay Manager's integration with the media library
Implementation Details
• Use standardized UML notation for clarity
• Annotations for critical processes
• Version control integration points
Documentation Elements
• Component descriptions
• API endpoints
• Configuration dependencies
• Supported external services
• Scaling points
Remember to include version information and note that this represents the current stable architecture, with potential variations in the develop and nightly branches.