# kroeberd/alldebrid-client architecture

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

- Interactive diagram: https://gitdiagram.com/kroeberd/alldebrid-client
- Repository: https://github.com/kroeberd/alldebrid-client

## Overview

AllDebrid-Client is a self-hosted torrent automation app. Users and media managers submit torrents through the web UI, qBittorrent-compatible API, or search integrations; the manager applies rules and coordinates AllDebrid upload, aria2 download, and completion work. Supporting branches provide scheduling, monitoring, notifications, and administration. The README documents the main lifecycle and several capabilities whose internal wiring is not shown here; those edges cite the README rather than implying unsampled calls.

Main entry points: [`backend/services/manager_v2.py`](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/manager_v2.py) (Torrent manager), [`backend/db/database.py`](https://github.com/kroeberd/alldebrid-client/blob/main/backend/db/database.py) (Torrent database), [`backend/core/scheduler.py`](https://github.com/kroeberd/alldebrid-client/blob/main/backend/core/scheduler.py) (Background scheduler), [`backend/api/routes.py`](https://github.com/kroeberd/alldebrid-client/blob/main/backend/api/routes.py) (REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Inputs and API"]
  node_web_ui["Web UI<br/>[app.js]"]
  node_rest_api["REST API<br/>[routes.py]"]
  node_qbit_api["qBittorrent API<br/>[qbit.py]"]
  node_search["Indexer search<br/>[jackett.py]"]
  node_prowlarr["Prowlarr search<br/>[prowlarr.py]"]
end

subgraph group_lifecycle["Torrent lifecycle"]
  node_manager["Torrent manager<br/>[manager_v2.py]"]
  node_rules["Pre-upload rules<br/>[rules.py]"]
  node_state["Lifecycle state<br/>[torrent_state.py]"]
  node_alldebrid["AllDebrid API<br/>[alldebrid.py]"]
  node_aria2_client["aria2 RPC client<br/>[aria2.py]"]
  node_aria2_runtime["Built-in aria2<br/>[aria2_runtime.py]"]
  node_extractor["Archive extraction<br/>[extractor.py]"]
end

subgraph group_operations["Operations and data"]
  node_database[("Torrent database<br/>[database.py]")]
  node_config["Application settings<br/>[config.py]"]
  node_scheduler["Background scheduler<br/>[scheduler.py]"]
  node_stats["Statistics and analytics<br/>[stats.py]"]
  node_analytics["Queue analytics<br/>[analytics.py]"]
  node_backup["Backups and maintenance<br/>[backup.py]"]
end

subgraph group_extensions["Integrations and outputs"]
  node_notifications["Discord notifications<br/>[notifications.py]"]
  node_webhooks["Lifecycle webhooks<br/>[webhook_actions.py]"]
  node_flexget["FlexGet tasks<br/>[flexget.py]"]
  node_media_services["Plex / Jellyfin<br/>[media_server.py]"]
end

node_user(("User"))
node_media_manager["Sonarr / Radarr"]
node_media_servers["Media servers"]

node_user -->|"submits torrents"| node_web_ui
node_web_ui -.->|"calls API"| node_rest_api
node_media_manager -->|"uses qBit API"| node_qbit_api
node_user -->|"submits torrents"| node_rest_api
node_user -->|"searches indexers"| node_search
node_user -->|"searches indexers"| node_prowlarr
node_search -.->|"adds results"| node_manager
node_prowlarr -.->|"adds results"| node_manager
node_rest_api -->|"adds torrents"| node_manager
node_qbit_api -->|"delegates torrent work"| node_manager
node_manager -->|"evaluates rules"| node_rules
node_manager -->|"validates transitions"| node_state
node_manager -->|"uploads and polls"| node_alldebrid
node_manager -->|"dispatches downloads"| node_aria2_client
node_aria2_runtime -->|"checks RPC"| node_aria2_client
node_manager -->|"extracts completed files"| node_extractor
node_manager -->|"reads and writes"| node_database
node_manager -->|"sends event notices"| node_notifications
node_manager -->|"fires lifecycle events"| node_webhooks
node_manager -->|"refreshes libraries"| node_media_services
node_media_services -->|"requests library refresh"| node_media_servers
node_scheduler -->|"runs background tasks"| node_manager
node_scheduler -->|"schedules backups"| node_backup
node_scheduler -->|"schedules tasks"| node_flexget
node_stats -->|"reads statistics"| node_database
node_analytics -->|"reads analytics data"| node_database
node_backup -->|"backs up data"| node_database
node_manager -->|"reads settings"| node_config
node_notifications -->|"reads webhook settings"| node_config
node_webhooks -->|"reads webhook settings"| node_config
node_user -->|"triggers tasks"| node_flexget

click node_web_ui "https://github.com/kroeberd/alldebrid-client/blob/main/frontend/static/app.js"
click node_rest_api "https://github.com/kroeberd/alldebrid-client/blob/main/backend/api/routes.py"
click node_qbit_api "https://github.com/kroeberd/alldebrid-client/blob/main/backend/api/qbit.py"
click node_search "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/jackett.py"
click node_prowlarr "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/prowlarr.py"
click node_manager "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/manager_v2.py"
click node_rules "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/rules.py"
click node_state "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/torrent_state.py"
click node_alldebrid "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/alldebrid.py"
click node_aria2_client "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/aria2.py"
click node_aria2_runtime "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/aria2_runtime.py"
click node_extractor "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/extractor.py"
click node_database "https://github.com/kroeberd/alldebrid-client/blob/main/backend/db/database.py"
click node_config "https://github.com/kroeberd/alldebrid-client/blob/main/backend/core/config.py"
click node_scheduler "https://github.com/kroeberd/alldebrid-client/blob/main/backend/core/scheduler.py"
click node_stats "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/stats.py"
click node_analytics "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/analytics.py"
click node_backup "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/backup.py"
click node_notifications "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/notifications.py"
click node_webhooks "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/webhook_actions.py"
click node_flexget "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/flexget.py"
click node_media_services "https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/media_server.py"

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_web_ui,node_rest_api,node_qbit_api,node_search,node_prowlarr,node_user toneBlue
class node_manager,node_rules,node_state,node_alldebrid,node_aria2_client,node_aria2_runtime,node_extractor toneAmber
class node_database,node_config,node_scheduler,node_stats,node_analytics,node_backup,node_media_servers toneMint
class node_notifications,node_webhooks,node_flexget,node_media_services toneRose
class node_media_manager toneIndigo
```

## Components

### Inputs and API

- [Web UI](https://github.com/kroeberd/alldebrid-client/blob/main/frontend/static/app.js): `frontend/static/app.js`
- [REST API](https://github.com/kroeberd/alldebrid-client/blob/main/backend/api/routes.py): `backend/api/routes.py`
- [qBittorrent API](https://github.com/kroeberd/alldebrid-client/blob/main/backend/api/qbit.py): `backend/api/qbit.py`
- [Indexer search](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/jackett.py): `backend/services/jackett.py`
- [Prowlarr search](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/prowlarr.py): `backend/services/prowlarr.py`

### Torrent lifecycle

- [Torrent manager](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/manager_v2.py): `backend/services/manager_v2.py`
- [Pre-upload rules](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/rules.py): `backend/services/rules.py`
- [Lifecycle state](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/torrent_state.py): `backend/services/torrent_state.py`
- [AllDebrid API](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/alldebrid.py): `backend/services/alldebrid.py`
- [aria2 RPC client](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/aria2.py): `backend/services/aria2.py`
- [Built-in aria2](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/aria2_runtime.py): `backend/services/aria2_runtime.py`
- [Archive extraction](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/extractor.py): `backend/services/extractor.py`

### Operations and data

- [Torrent database](https://github.com/kroeberd/alldebrid-client/blob/main/backend/db/database.py): `backend/db/database.py`
- [Application settings](https://github.com/kroeberd/alldebrid-client/blob/main/backend/core/config.py): `backend/core/config.py`
- [Background scheduler](https://github.com/kroeberd/alldebrid-client/blob/main/backend/core/scheduler.py): `backend/core/scheduler.py`
- [Statistics and analytics](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/stats.py): `backend/services/stats.py`
- [Queue analytics](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/analytics.py): `backend/services/analytics.py`
- [Backups and maintenance](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/backup.py): `backend/services/backup.py`

### Integrations and outputs

- [Discord notifications](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/notifications.py): `backend/services/notifications.py`
- [Lifecycle webhooks](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/webhook_actions.py): `backend/services/webhook_actions.py`
- [FlexGet tasks](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/flexget.py): `backend/services/flexget.py`
- [Plex / Jellyfin](https://github.com/kroeberd/alldebrid-client/blob/main/backend/services/media_server.py): `backend/services/media_server.py`

### Other components

- **User**
- **Sonarr / Radarr**
- **Media servers**

## Connections

- User → Web UI: submits torrents (evidence: `README.md`)
- Web UI → REST API: calls API
- Sonarr / Radarr → qBittorrent API: uses qBit API (evidence: `README.md`)
- User → REST API: submits torrents (evidence: `README.md`)
- User → Indexer search: searches indexers (evidence: `README.md`)
- User → Prowlarr search: searches indexers (evidence: `README.md`)
- Indexer search → Torrent manager: adds results
- Prowlarr search → Torrent manager: adds results
- REST API → Torrent manager: adds torrents (evidence: `backend/api/routes.py`)
- qBittorrent API → Torrent manager: delegates torrent work (evidence: `backend/api/qbit.py`)
- Torrent manager → Pre-upload rules: evaluates rules (evidence: `backend/services/manager_v2.py`)
- Torrent manager → Lifecycle state: validates transitions (evidence: `backend/services/manager_v2.py`)
- Torrent manager → AllDebrid API: uploads and polls (evidence: `backend/services/manager_v2.py`)
- Torrent manager → aria2 RPC client: dispatches downloads (evidence: `backend/services/manager_v2.py`)
- Built-in aria2 → aria2 RPC client: checks RPC (evidence: `backend/services/aria2_runtime.py`)
- Torrent manager → Archive extraction: extracts completed files (evidence: `backend/services/manager_v2.py`)
- Torrent manager → Torrent database: reads and writes (evidence: `backend/services/manager_v2.py`)
- Torrent manager → Discord notifications: sends event notices (evidence: `backend/services/manager_v2.py`)
- Torrent manager → Lifecycle webhooks: fires lifecycle events (evidence: `backend/services/manager_v2.py`)
- Torrent manager → Plex / Jellyfin: refreshes libraries (evidence: `backend/services/manager_v2.py`)
- Plex / Jellyfin → Media servers: requests library refresh (evidence: `README.md`)
- Background scheduler → Torrent manager: runs background tasks (evidence: `backend/core/scheduler.py`)
- Background scheduler → Backups and maintenance: schedules backups (evidence: `backend/core/scheduler.py`)
- Background scheduler → FlexGet tasks: schedules tasks (evidence: `backend/core/scheduler.py`)
- Statistics and analytics → Torrent database: reads statistics (evidence: `backend/services/stats.py`)
- Queue analytics → Torrent database: reads analytics data (evidence: `backend/services/analytics.py`)
- Backups and maintenance → Torrent database: backs up data (evidence: `backend/services/backup.py`)
- Torrent manager → Application settings: reads settings (evidence: `backend/services/manager_v2.py`)
- Discord notifications → Application settings: reads webhook settings (evidence: `backend/services/notifications.py`)
- Lifecycle webhooks → Application settings: reads webhook settings (evidence: `backend/services/webhook_actions.py`)
- User → FlexGet tasks: triggers tasks (evidence: `README.md`)
