# infiniteavenger/jellio-plus architecture

> Architecture diagram of the GitHub repository infiniteavenger/jellio-plus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/infiniteavenger/jellio-plus
- Repository: https://github.com/infiniteavenger/jellio-plus

## Overview

##### Project type and purpose
- This is a **Jellyfin plugin** (“Jellio+”) written in C# (.NET Core) that exposes a Stremio add-on API, plus a **separate React/TypeScript web UI** (jellio-web) for configuring the plugin inside Jellyfin’s Dashboard.
- Purpose: Bridge Jellyfin media server libraries into Stremio; optionally send content requests to a Jellyseer service.

##### File structure
- Top-level:
- Jellyfin.Plugin.Jellio/ (backend plugin)
- jellio-web/ (frontend config UI)
- assets/, README.md, solution and project files
- Jellyfin.Plugin.Jellio:
- Controllers: AddonController (Stremio API), AuthController, RequestController (Jellyseer), WebController (serves config.html, index.html)
- Helpers: JSON binding, authorization filters, Jellyfin library helpers, request utility
- Models: DTOs (MetaDto, StreamDto, VideoDto), ConfigModel, SaveConfigRequest
- Web: static HTML/CSS/JS shipped to Jellyfin UI
- jellio-web:
- React app with components/form fields for configuration, hooks for storage and API calls, backendService (calls plugin’s API)
- build scripts and Vite configuration

##### README for additional insights
- Explains plugin registers itself through Jellyfin’s plugin system, provides a Stremio add-on endpoint URL that you paste into Stremio.
- Mentions optional Jellyseer integration (plugin calls external Jellyseer API).

##### Main components
a. **Jellyfin Server**
– Hosts the Jellio+ plugin
– Holds the media library (movies, TV shows)
b. **Jellio+ Plugin (C# .NET)**
– Controllers (AddonController, AuthController, RequestController, WebController)
– Helpers & Models
– Configuration store (persisted via Jellyfin’s plugin framework)
c. **Static Web UI** (config.html, index.html, redirect.html)
– Served by WebController inside Jellyfin Dashboard
– Built from jellio-web React app
d. **Stremio Client**
– Consumes the add-on manifest and streams from Plugin’s AddonController
e. **Optional Jellyseer Service**
– External API endpoint for media requests
f. **Build/CI Pipeline**
– GitHub Actions (release.yml) building plugin and jellio-web, packaging assets

##### Relationships & interactions
- **Flow A (Browsing & Streaming):**
Stremio → HTTP GET /manifest via AddonController → returns catalog items (MetaDto)
Stremio → HTTP GET /stream/{id} → Plugin authenticates with Jellyfin (AuthController/Helpers) → proxies media segments from Jellyfin → returns HLS/DASH stream to Stremio.
- **Flow B (Configuration UI):**
Admin user in Jellyfin UI → WebController serves config.html → React app loads → calls backendService (plugin’s REST endpoints) → fetch/save ConfigModel.
- **Flow C (Jellyseer Request):**
User from Stremio requests missing media → RequestController relays request to Jellyseer API with API key.
- **Build Flow:**
jellio-web (Vite) → produces static assets → copied into Jellyfin.Plugin.Jellio/Web → included in plugin package → deployed via Jellyfin plugin repository.

##### Architectural patterns & design principles
- **MVC** inside plugin: Controllers + Models + Helpers
- **Separation of Concerns:** plugin logic vs. UI layer
- **Stateless HTTP API** for Stremio integration
- **Modular Frontend** (React hooks + components)
- **Plugin-based deployment** using Jellyfin’s plugin framework

##### Detail
- Configuration file locations or storage if relevant
- Plugin’s dependency on .NET runtime and Vite build for UI

## Diagram (Mermaid)

```mermaid
flowchart TD
    StremioClient["Stremio Client"]:::external
    JellyseerAPI["Jellyseer API"]:::external

    subgraph "Jellyfin Server" 
        direction TB
        JellyfinHost["Jellyfin Host\n(.NET Core Runtime)"]:::host
        MediaLibrary["Media Library"]:::storage
        ConfigStore["Plugin Config Store"]:::storage

        subgraph "Jellio+ Plugin" 
            direction TB
            PluginEntry["Plugin.cs"]:::plugin
            PluginConfigModel["PluginConfiguration.cs"]:::model

            subgraph "Controllers" 
                direction TB
                AddonController["AddonController"]:::controller
                AuthController["AuthController"]:::controller
                RequestController["RequestController"]:::controller
                WebController["WebController"]:::controller
            end

            subgraph "Helpers" 
                direction TB
                JsonBinder["Base64JsonModelBinder.cs"]:::helper
                ConfigFilter1["ConfigAuthFilter.cs"]:::helper
                ConfigFilter2["ConfigAuthorizeAttribute.cs"]:::helper
                ConfigFromJson["ConfigFromBase64Json.cs"]:::helper
                LibraryHelper["LibraryHelper.cs"]:::helper
                RequestHelpers["RequestHelpers.cs"]:::helper
            end

            subgraph "Models" 
                direction TB
                ConfigModel["ConfigModel.cs"]:::model
                SaveConfig["SaveConfigRequest.cs"]:::model
                MetaDto["MetaDto.cs"]:::model
                StreamDto["StreamDto.cs"]:::model
                VideoDto["VideoDto.cs"]:::model
                StremioType["StremioType.cs"]:::model
            end

            subgraph "Static Web UI Assets" 
                direction TB
                StaticUI["/Web (config.html, index.html, redirect.html)"]:::ui
            end
        end
    end

    subgraph "React Configuration UI (jellio-web)" 
        direction TB
        PackageJson["package.json"]:::frontend
        ViteConfig["vite.config.js"]:::frontend
        MainTSX["main.tsx"]:::frontend
        AppTSX["App.tsx"]:::frontend
        ConfigPage["ConfigFormPage.tsx"]:::frontend
        BackendService["backendService.ts"]:::frontend
        JellyseerrField["jellyseerr.tsx"]:::frontend
    end

    subgraph "Build/CI Pipeline" 
        direction TB
        ReleaseWorkflow["release.yml"]:::build
    end

    %% Flows
    StremioClient -->|"GET /manifest\nGET /stream/{id}"| AddonController
    AddonController -->|proxies| AuthController
    AuthController -->|auth & fetch| MediaLibrary
    RequestController -->|relay| JellyseerAPI
    WebController -->|serves UI assets| StaticUI
    StaticUI -->|loaded in Dashboard| JellyfinHost

    subgraph "UI Interaction"
        direction TB
        AdminUser["Admin User"]:::external
        AdminUser -->|open config.html| WebController
        ReactUI["React App"]:::frontend
        ReactUI -->|REST calls| WebController
    end

    %% Config storage flow
    WebController -->|load/save config| ConfigStore

    %% CI flow
    PackageJson -->|build via Vite| StaticUI
    AppTSX -->|bundle| StaticUI
    ReleaseWorkflow -->|packages plugin & UI| JellyfinHost

    %% Click Events
    click JellyfinHost "https://github.com/infiniteavenger/jellio-plus/tree/main/Jellyfin.Plugin.Jellio/"
    click PluginEntry "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Plugin.cs"
    click PluginConfigModel "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Configuration/PluginConfiguration.cs"
    click AddonController "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Controllers/AddonController.cs"
    click AuthController "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Controllers/AuthController.cs"
    click RequestController "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Controllers/RequestController.cs"
    click WebController "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Controllers/WebController.cs"
    click JsonBinder "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Helpers/Base64JsonModelBinder.cs"
    click ConfigFilter1 "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Helpers/ConfigAuthFilter.cs"
    click ConfigFilter2 "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Helpers/ConfigAuthorizeAttribute.cs"
    click ConfigFromJson "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Helpers/ConfigFromBase64Json.cs"
    click LibraryHelper "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Helpers/LibraryHelper.cs"
    click RequestHelpers "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Helpers/RequestHelpers.cs"
    click ConfigModel "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Models/ConfigModel.cs"
    click SaveConfig "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Models/SaveConfigRequest.cs"
    click MetaDto "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Models/MetaDto.cs"
    click StreamDto "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Models/StreamDto.cs"
    click VideoDto "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Models/VideoDto.cs"
    click StremioType "https://github.com/infiniteavenger/jellio-plus/blob/main/Jellyfin.Plugin.Jellio/Models/StremioType.cs"
    click StaticUI "https://github.com/infiniteavenger/jellio-plus/tree/main/Jellyfin.Plugin.Jellio/Web/"
    click PackageJson "https://github.com/infiniteavenger/jellio-plus/blob/main/jellio-web/package.json"
    click ViteConfig "https://github.com/infiniteavenger/jellio-plus/blob/main/jellio-web/vite.config.js"
    click MainTSX "https://github.com/infiniteavenger/jellio-plus/blob/main/jellio-web/src/main.tsx"
    click AppTSX "https://github.com/infiniteavenger/jellio-plus/blob/main/jellio-web/src/App.tsx"
    click ConfigPage "https://github.com/infiniteavenger/jellio-plus/blob/main/jellio-web/src/pages/ConfigFormPage.tsx"
    click BackendService "https://github.com/infiniteavenger/jellio-plus/blob/main/jellio-web/src/services/backendService.ts"
    click JellyseerrField "https://github.com/infiniteavenger/jellio-plus/blob/main/jellio-web/src/components/configForm/fields/jellyseerr.tsx"
    click ReleaseWorkflow "https://github.com/infiniteavenger/jellio-plus/blob/main/.github/workflows/release.yml"

    %% Styles
    classDef external fill:#f9f,stroke:#333,stroke-width:1px
    classDef host fill:#ccf,stroke:#333,stroke-width:1px
    classDef plugin fill:#cfc,stroke:#333,stroke-width:1px
    classDef controller fill:#fcf,stroke:#333,stroke-width:1px
    classDef helper fill:#cff,stroke:#333,stroke-width:1px
    classDef model fill:#ffc,stroke:#333,stroke-width:1px
    classDef ui fill:#ecc,stroke:#333,stroke-width:1px
    classDef frontend fill:#eef,stroke:#333,stroke-width:1px
    classDef storage fill:#ddf,stroke:#333,stroke-width:1px
    classDef build fill:#ffd,stroke:#333,stroke-width:1px
```
