# mohdsuhailpgdi/jellyfetch architecture

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

- Interactive diagram: https://gitdiagram.com/mohdsuhailpgdi/jellyfetch
- Repository: https://github.com/mohdsuhailpgdi/jellyfetch

## Overview

JellyFetch is a Jellyfin plugin for regional-media discovery, cloud-assisted downloads, and library maintenance. Users configure providers and start manual downloads or scraping from the plugin dashboard; scraper runs create library placeholder files, while download and maintenance operations are coordinated by the controller and scheduled-task adapters. Provider helpers integrate Seedr and Torbox, and the plugin also injects download controls into Jellyfin’s item-detail UI. The source excerpts establish the controller/helper and task call paths; README statements support some capabilities whose implementation details were not sampled.

Main entry points: [`Api/DownloadersController.cs`](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Api/DownloadersController.cs) (Download and task API), [`Helpers/JellyfinScraper.cs`](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/JellyfinScraper.cs) (Release scraper), [`Plugin.cs`](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Plugin.cs) (Plugin registration), [`Tasks/ScraperScheduledTask.cs`](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Tasks/ScraperScheduledTask.cs) (Scraper task)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Jellyfin interface"]
  node_dashboard["Plugin dashboard<br/>[downloaders.js]"]
  node_detailui["Movie detail controls"]
  node_plugin["Plugin registration<br/>[Plugin.cs]"]
end

subgraph group_orchestration["Workflow orchestration"]
  node_config["Plugin settings"]
  node_controller["Download and task API"]
  node_scrape_task["Scraper task"]
  node_cleanup_task["Placeholder cleanup task"]
  node_sanitize_task["Metadata sanitize task"]
end

subgraph group_providers["Scraping and providers"]
  node_scraper["Release scraper<br/>[JellyfinScraper.cs]"]
  node_seedr["Seedr downloader<br/>[SeedrHelper.cs]"]
  node_torbox["Torbox downloader<br/>[TorboxHelper.cs]"]
end

subgraph group_maintenance["Library and state"]
  node_history[("Download history")]
end

node_user(("Jellyfin user"))
node_forums["1TamilMV forums"]
node_tmdb_omdb["TMDB and OMDb"]
node_seedr_service["Seedr service"]
node_torbox_service["Torbox service"]
node_jellyfin_library["Jellyfin library"]

node_user -->|"uses"| node_dashboard
node_user -->|"requests downloads"| node_detailui
node_plugin -->|"registers page"| node_dashboard
node_plugin -->|"installs injection"| node_detailui
node_scrape_task -->|"runs scrape"| node_scraper
node_scrape_task -->|"reports progress"| node_controller
node_cleanup_task -->|"runs cleanup"| node_controller
node_sanitize_task -->|"runs sanitize"| node_controller
node_controller -->|"reads settings"| node_config
node_controller -->|"invokes scraping"| node_scraper
node_controller -->|"invokes downloads"| node_seedr
node_controller -->|"invokes downloads"| node_torbox
node_controller -->|"records activity"| node_history
node_controller -->|"validates library"| node_jellyfin_library
node_scraper -->|"searches releases"| node_forums
node_scraper -->|"checks language"| node_tmdb_omdb
node_seedr -->|"calls API"| node_seedr_service
node_torbox -->|"calls API"| node_torbox_service

click node_dashboard "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Web/downloaders.js"
click node_detailui "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Web/jellyfetch-inject.js"
click node_plugin "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Plugin.cs"
click node_config "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Configuration/PluginConfiguration.cs"
click node_controller "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Api/DownloadersController.cs"
click node_scrape_task "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Tasks/ScraperScheduledTask.cs"
click node_cleanup_task "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Tasks/CleanupScheduledTask.cs"
click node_sanitize_task "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Tasks/SanitizeScheduledTask.cs"
click node_scraper "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/JellyfinScraper.cs"
click node_seedr "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/SeedrHelper.cs"
click node_torbox "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/TorboxHelper.cs"
click node_history "https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/DownloadHistoryManager.cs"

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_dashboard,node_detailui,node_plugin,node_user toneBlue
class node_config,node_controller,node_scrape_task,node_cleanup_task,node_sanitize_task toneAmber
class node_scraper,node_seedr,node_torbox toneMint
class node_history toneRose
class node_forums,node_tmdb_omdb,node_seedr_service,node_torbox_service,node_jellyfin_library toneIndigo
```

## Components

### Jellyfin interface

- [Plugin dashboard](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Web/downloaders.js): `Web/downloaders.js`
- [Movie detail controls](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Web/jellyfetch-inject.js): `Web/jellyfetch-inject.js`
- [Plugin registration](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Plugin.cs): `Plugin.cs`

### Workflow orchestration

- [Plugin settings](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Configuration/PluginConfiguration.cs): `Configuration/PluginConfiguration.cs`
- [Download and task API](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Api/DownloadersController.cs): `Api/DownloadersController.cs`
- [Scraper task](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Tasks/ScraperScheduledTask.cs): `Tasks/ScraperScheduledTask.cs`
- [Placeholder cleanup task](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Tasks/CleanupScheduledTask.cs): `Tasks/CleanupScheduledTask.cs`
- [Metadata sanitize task](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Tasks/SanitizeScheduledTask.cs): `Tasks/SanitizeScheduledTask.cs`

### Scraping and providers

- [Release scraper](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/JellyfinScraper.cs): `Helpers/JellyfinScraper.cs`
- [Seedr downloader](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/SeedrHelper.cs): `Helpers/SeedrHelper.cs`
- [Torbox downloader](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/TorboxHelper.cs): `Helpers/TorboxHelper.cs`

### Library and state

- [Download history](https://github.com/mohdsuhailpgdi/jellyfetch/blob/main/Helpers/DownloadHistoryManager.cs): `Helpers/DownloadHistoryManager.cs`

### Other components

- **Jellyfin user**
- **1TamilMV forums**
- **TMDB and OMDb**
- **Seedr service**
- **Torbox service**
- **Jellyfin library**

## Connections

- Jellyfin user → Plugin dashboard: uses (evidence: `README.md`)
- Jellyfin user → Movie detail controls: requests downloads (evidence: `README.md`)
- Plugin registration → Plugin dashboard: registers page (evidence: `Plugin.cs`)
- Plugin registration → Movie detail controls: installs injection (evidence: `Plugin.cs`)
- Scraper task → Release scraper: runs scrape (evidence: `Tasks/ScraperScheduledTask.cs`)
- Scraper task → Download and task API: reports progress (evidence: `Tasks/ScraperScheduledTask.cs`)
- Placeholder cleanup task → Download and task API: runs cleanup (evidence: `Tasks/CleanupScheduledTask.cs`)
- Metadata sanitize task → Download and task API: runs sanitize (evidence: `Tasks/SanitizeScheduledTask.cs`)
- Download and task API → Plugin settings: reads settings (evidence: `Api/DownloadersController.cs`)
- Download and task API → Release scraper: invokes scraping (evidence: `Api/DownloadersController.cs`)
- Download and task API → Seedr downloader: invokes downloads (evidence: `Api/DownloadersController.cs`)
- Download and task API → Torbox downloader: invokes downloads (evidence: `Api/DownloadersController.cs`)
- Download and task API → Download history: records activity (evidence: `Api/DownloadersController.cs`)
- Download and task API → Jellyfin library: validates library (evidence: `Api/DownloadersController.cs`)
- Release scraper → 1TamilMV forums: searches releases (evidence: `Helpers/JellyfinScraper.cs`)
- Release scraper → TMDB and OMDb: checks language (evidence: `README.md`)
- Seedr downloader → Seedr service: calls API (evidence: `Helpers/SeedrHelper.cs`)
- Torbox downloader → Torbox service: calls API (evidence: `Helpers/TorboxHelper.cs`)
