# n00bcodr/jellyfin-enhanced architecture

> Architecture diagram of the GitHub repository n00bcodr/jellyfin-enhanced, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/n00bcodr/jellyfin-enhanced
- Repository: https://github.com/n00bcodr/jellyfin-enhanced

## Overview

Jellyfin Enhanced is a server-installed Jellyfin plugin that adds optional, per-user web-app and server-side features. A viewer uses the enhanced Jellyfin interface; for Seerr requests, the plugin also coordinates with Seerr, while scheduled synchronization and event-driven services support background capabilities. The graph preserves the README’s major feature areas and connects only relationships documented there or visible in indexed source. Several subsystems are represented at directory level because their implementation files were not sampled.

Main entry points: [`Jellyfin.Plugin.JellyfinEnhanced/js/plugin.js`](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/js/plugin.js) (Enhanced web UI), [`Jellyfin.Plugin.JellyfinEnhanced/JellyfinEnhanced.cs`](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/JellyfinEnhanced.cs) (Plugin startup), [`Jellyfin.Plugin.JellyfinEnhanced/Helpers/Jellyseerr/SeerrHttpHelper.cs`](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Helpers/Jellyseerr/SeerrHttpHelper.cs) (Seerr HTTP client), [`Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks/JellyseerrWatchlistSyncTask.cs`](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks/JellyseerrWatchlistSyncTask.cs) (Watchlist sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin runtime"]
  node_plugin["Plugin startup"]
  node_registration["Service registration"]
  node_settings[("User settings")]
  node_api["Plugin API"]
end

subgraph group_media["Media experience"]
  node_web["Enhanced web UI<br/>[plugin.js]"]
  node_tags["Poster tags<br/>[TagCacheService.cs]"]
  node_tagui["Tag rendering<br/>[tag-pipeline.js]"]
  node_spoilers["Spoiler protection"]
  node_player["Player enhancements<br/>[player]"]
  node_details["Richer media pages<br/>[reviews.js]"]
end

subgraph group_seerr["Seerr integration"]
  node_seerrui["Requests and discovery<br/>[jellyseerr]"]
  node_seerrclient["Seerr HTTP client<br/>[SeerrHttpHelper.cs]"]
  node_automation["Automatic requests"]
  node_watchsync["Watchlist sync"]
end

subgraph group_household["Household features"]
  node_activity["Household activity<br/>[ActivityService.cs]"]
  node_activityevents["Playback activity events"]
end

subgraph group_operations["Server capabilities"]
  node_calendar["Release calendar<br/>[calendar]"]
  node_admin["Admin controls"]
  node_tasks["Scheduled tasks<br/>[ScheduledTasks]"]
end

node_viewer(("Jellyfin viewer"))
node_jellyfin["Jellyfin server"]
node_seerr["Seerr service"]

node_viewer -->|"uses"| node_web
node_jellyfin -->|"hosts"| node_plugin
node_plugin -->|"registers services"| node_registration
node_plugin -->|"loads configuration"| node_settings
node_viewer -->|"chooses features"| node_settings
node_web -->|"shows poster tags"| node_tags
node_tags -.->|"supplies tag data"| node_tagui
node_jellyfin -->|"filters server responses"| node_spoilers
node_web -->|"uses enhanced playback"| node_player
node_web -->|"shows richer pages"| node_details
node_viewer -->|"requests media"| node_seerrui
node_seerrui -.->|"requests service data"| node_seerrclient
node_seerrclient -->|"sends HTTP requests"| node_seerr
node_automation -.->|"submits requests"| node_seerr
node_watchsync -->|"uses HTTP helper"| node_seerrclient
node_watchsync -->|"syncs watchlists"| node_seerr
node_viewer -->|"views household activity"| node_activity
node_activityevents -.->|"records playback activity"| node_activity
node_viewer -->|"views releases"| node_calendar
node_admin -.->|"configures features"| node_tasks

click node_plugin "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/JellyfinEnhanced.cs"
click node_registration "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/PluginServiceRegistrator.cs"
click node_settings "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Configuration/UserConfigurationManager.cs"
click node_api "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Controllers/JellyfinEnhancedController.cs"
click node_web "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/js/plugin.js"
click node_tags "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Services/TagCacheService.cs"
click node_tagui "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/js/tags/tag-pipeline.js"
click node_spoilers "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Services/SpoilerGuard/SpoilerBlurImageFilter.cs"
click node_player "https://github.com/n00bcodr/jellyfin-enhanced/tree/main/Jellyfin.Plugin.JellyfinEnhanced/js/enhanced/player"
click node_details "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/js/elsewhere/reviews.js"
click node_seerrui "https://github.com/n00bcodr/jellyfin-enhanced/tree/main/Jellyfin.Plugin.JellyfinEnhanced/js/jellyseerr"
click node_seerrclient "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Helpers/Jellyseerr/SeerrHttpHelper.cs"
click node_automation "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Services/AutoSeasonRequestService.cs"
click node_watchsync "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks/JellyseerrWatchlistSyncTask.cs"
click node_activity "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Services/ActivityService.cs"
click node_activityevents "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/EventHandlers/ContinueWatchingPlaybackEvents.cs"
click node_calendar "https://github.com/n00bcodr/jellyfin-enhanced/tree/main/Jellyfin.Plugin.JellyfinEnhanced/js/arr/calendar"
click node_admin "https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Configuration/PluginConfiguration.cs"
click node_tasks "https://github.com/n00bcodr/jellyfin-enhanced/tree/main/Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_registration,node_settings,node_api,node_viewer toneBlue
class node_web,node_tags,node_tagui,node_spoilers,node_player,node_details toneAmber
class node_seerrui,node_seerrclient,node_automation,node_watchsync,node_jellyfin toneMint
class node_activity,node_activityevents toneRose
class node_calendar,node_admin,node_tasks,node_seerr toneIndigo
```

## Components

### Plugin runtime

- [Plugin startup](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/JellyfinEnhanced.cs): `Jellyfin.Plugin.JellyfinEnhanced/JellyfinEnhanced.cs`
- [Service registration](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/PluginServiceRegistrator.cs): `Jellyfin.Plugin.JellyfinEnhanced/PluginServiceRegistrator.cs`
- [User settings](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Configuration/UserConfigurationManager.cs): `Jellyfin.Plugin.JellyfinEnhanced/Configuration/UserConfigurationManager.cs`
- [Plugin API](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Controllers/JellyfinEnhancedController.cs): `Jellyfin.Plugin.JellyfinEnhanced/Controllers/JellyfinEnhancedController.cs`

### Media experience

- [Enhanced web UI](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/js/plugin.js): `Jellyfin.Plugin.JellyfinEnhanced/js/plugin.js`
- [Poster tags](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Services/TagCacheService.cs): `Jellyfin.Plugin.JellyfinEnhanced/Services/TagCacheService.cs`
- [Tag rendering](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/js/tags/tag-pipeline.js): `Jellyfin.Plugin.JellyfinEnhanced/js/tags/tag-pipeline.js`
- [Spoiler protection](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Services/SpoilerGuard/SpoilerBlurImageFilter.cs): `Jellyfin.Plugin.JellyfinEnhanced/Services/SpoilerGuard/SpoilerBlurImageFilter.cs`
- [Player enhancements](https://github.com/n00bcodr/jellyfin-enhanced/tree/main/Jellyfin.Plugin.JellyfinEnhanced/js/enhanced/player): `Jellyfin.Plugin.JellyfinEnhanced/js/enhanced/player`
- [Richer media pages](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/js/elsewhere/reviews.js): `Jellyfin.Plugin.JellyfinEnhanced/js/elsewhere/reviews.js`

### Seerr integration

- [Requests and discovery](https://github.com/n00bcodr/jellyfin-enhanced/tree/main/Jellyfin.Plugin.JellyfinEnhanced/js/jellyseerr): `Jellyfin.Plugin.JellyfinEnhanced/js/jellyseerr`
- [Seerr HTTP client](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Helpers/Jellyseerr/SeerrHttpHelper.cs): `Jellyfin.Plugin.JellyfinEnhanced/Helpers/Jellyseerr/SeerrHttpHelper.cs`
- [Automatic requests](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Services/AutoSeasonRequestService.cs): `Jellyfin.Plugin.JellyfinEnhanced/Services/AutoSeasonRequestService.cs`
- [Watchlist sync](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks/JellyseerrWatchlistSyncTask.cs): `Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks/JellyseerrWatchlistSyncTask.cs`

### Household features

- [Household activity](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Services/ActivityService.cs): `Jellyfin.Plugin.JellyfinEnhanced/Services/ActivityService.cs`
- [Playback activity events](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/EventHandlers/ContinueWatchingPlaybackEvents.cs): `Jellyfin.Plugin.JellyfinEnhanced/EventHandlers/ContinueWatchingPlaybackEvents.cs`

### Server capabilities

- [Release calendar](https://github.com/n00bcodr/jellyfin-enhanced/tree/main/Jellyfin.Plugin.JellyfinEnhanced/js/arr/calendar): `Jellyfin.Plugin.JellyfinEnhanced/js/arr/calendar`
- [Admin controls](https://github.com/n00bcodr/jellyfin-enhanced/blob/main/Jellyfin.Plugin.JellyfinEnhanced/Configuration/PluginConfiguration.cs): `Jellyfin.Plugin.JellyfinEnhanced/Configuration/PluginConfiguration.cs`
- [Scheduled tasks](https://github.com/n00bcodr/jellyfin-enhanced/tree/main/Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks): `Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks`

### Other components

- **Jellyfin viewer**
- **Jellyfin server**
- **Seerr service**

## Connections

- Jellyfin viewer → Enhanced web UI: uses
- Jellyfin server → Plugin startup: hosts
- Plugin startup → Service registration: registers services (evidence: `Jellyfin.Plugin.JellyfinEnhanced/PluginServiceRegistrator.cs`)
- Plugin startup → User settings: loads configuration (evidence: `Jellyfin.Plugin.JellyfinEnhanced/JellyfinEnhanced.cs`)
- Jellyfin viewer → User settings: chooses features
- Enhanced web UI → Poster tags: shows poster tags
- Poster tags → Tag rendering: supplies tag data
- Jellyfin server → Spoiler protection: filters server responses
- Enhanced web UI → Player enhancements: uses enhanced playback
- Enhanced web UI → Richer media pages: shows richer pages
- Jellyfin viewer → Requests and discovery: requests media
- Requests and discovery → Seerr HTTP client: requests service data
- Seerr HTTP client → Seerr service: sends HTTP requests (evidence: `Jellyfin.Plugin.JellyfinEnhanced/Helpers/Jellyseerr/SeerrHttpHelper.cs`)
- Automatic requests → Seerr service: submits requests
- Watchlist sync → Seerr HTTP client: uses HTTP helper (evidence: `Jellyfin.Plugin.JellyfinEnhanced/ScheduledTasks/JellyseerrWatchlistSyncTask.cs`)
- Watchlist sync → Seerr service: syncs watchlists
- Jellyfin viewer → Household activity: views household activity
- Playback activity events → Household activity: records playback activity
- Jellyfin viewer → Release calendar: views releases
- Admin controls → Scheduled tasks: configures features
