# persepolisdm/persepolis architecture

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

- Interactive diagram: https://gitdiagram.com/persepolisdm/persepolis
- Repository: https://github.com/persepolisdm/persepolis

## Overview

Persepolis is a desktop download manager. Users submit links through the GUI or browser integration; the application validates and queues work, then runs ordinary or video downloads while presenting status and retaining download state. Scheduling, queueing, multi-segment transfers, and video retrieval are documented capabilities. The source index supports the main module relationships; unsampled feature wiring is shown only as unverified dashed links.

Main entry points: [`persepolis/scripts/mainwindow.py`](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/mainwindow.py) (Main Window), [`persepolis/scripts/queue.py`](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/queue.py) (Download Queue), [`persepolis/scripts/addlink.py`](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/addlink.py) (Add Link), [`persepolis/scripts/video_finder.py`](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/video_finder.py) (Video Finder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app_entry["Application Entry<br/>[persepolis.py]"]
  node_main_window["Main Window<br/>[mainwindow.py]"]
  node_main_ui["Main Window UI<br/>[mainwindow_ui.py]"]
  node_settings["Settings<br/>[setting.py]"]
  node_settings_ui["Settings UI<br/>[setting_ui.py]"]
  node_progress["Progress View<br/>[progress.py]"]
  node_after_download["Completion Actions<br/>[after_download.py]"]
end

subgraph group_intake["Link Intake"]
  node_link_entry["Add Link<br/>[addlink.py]"]
  node_link_ui["Add Link UI<br/>[addlink_ui.py]"]
  node_browser["Browser Integration"]
  node_browser_queue["Browser Link Queue"]
  node_text_queue["Text Link Queue<br/>[text_queue.py]"]
  node_spider["Link Inspection<br/>[spider.py]"]
  node_proxy_check["Proxy Check<br/>[check_proxy.py]"]
end

subgraph group_downloads["Download Runtime"]
  node_queue["Download Queue<br/>[queue.py]"]
  node_segmented["Segmented Downloader"]
  node_video_finder["Video Finder<br/>[video_finder.py]"]
  node_ytdlp["Video Downloader"]
end

subgraph group_state["State and Support"]
  node_database[("Download Database<br/>[data_base.py]")]
  node_logger["Logging<br/>[logger.py]"]
end

node_user(("Desktop User"))
node_http(("HTTP Services"))
node_ffmpeg(("FFmpeg"))
node_yt_dlp_project(("yt-dlp"))

node_user -.->|"uses"| node_main_window
node_app_entry -->|"starts"| node_main_window
node_app_entry -->|"initializes"| node_database
node_main_window -.->|"uses"| node_main_ui
node_main_window -->|"invokes"| node_link_entry
node_main_window -->|"dispatches"| node_queue
node_main_window -->|"invokes"| node_video_finder
node_main_window -->|"opens"| node_settings
node_main_window -->|"opens"| node_progress
node_main_window -->|"opens"| node_text_queue
node_settings -->|"uses"| node_settings_ui
node_link_entry -->|"uses"| node_link_ui
node_link_entry -->|"inspects links"| node_spider
node_link_entry -->|"checks proxy"| node_proxy_check
node_browser -.->|"submits links"| node_browser_queue
node_browser_queue -->|"uses"| node_text_queue
node_text_queue -->|"inspects links"| node_spider
node_queue -->|"dispatches"| node_segmented
node_queue -->|"dispatches"| node_video_finder
node_queue -->|"dispatches"| node_ytdlp
node_video_finder -->|"uses"| node_ytdlp
node_segmented -->|"requests data"| node_http
node_ytdlp -.->|"uses"| node_yt_dlp_project
node_video_finder -.->|"merges media"| node_ffmpeg
node_main_window -.->|"reads and writes"| node_database
node_queue -.->|"updates state"| node_database
node_main_window -->|"logs events"| node_logger
node_link_entry -->|"logs events"| node_logger
node_queue -->|"logs events"| node_logger
node_main_window -.->|"runs completion"| node_after_download
node_settings -->|"configures integration"| node_browser

click node_app_entry "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/persepolis.py"
click node_main_window "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/mainwindow.py"
click node_main_ui "https://github.com/persepolisdm/persepolis/blob/master/persepolis/gui/mainwindow_ui.py"
click node_settings "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/setting.py"
click node_settings_ui "https://github.com/persepolisdm/persepolis/blob/master/persepolis/gui/setting_ui.py"
click node_progress "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/progress.py"
click node_after_download "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/after_download.py"
click node_link_entry "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/addlink.py"
click node_link_ui "https://github.com/persepolisdm/persepolis/blob/master/persepolis/gui/addlink_ui.py"
click node_browser "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/browser_integration.py"
click node_browser_queue "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/browser_plugin_queue.py"
click node_text_queue "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/text_queue.py"
click node_spider "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/spider.py"
click node_proxy_check "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/check_proxy.py"
click node_queue "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/queue.py"
click node_segmented "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/persepolis_lib_prime.py"
click node_video_finder "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/video_finder.py"
click node_ytdlp "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/ytdlp_downloader.py"
click node_database "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/data_base.py"
click node_logger "https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/logger.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_app_entry,node_main_window,node_main_ui,node_settings,node_settings_ui,node_progress,node_after_download,node_user toneBlue
class node_link_entry,node_link_ui,node_browser,node_browser_queue,node_text_queue,node_spider,node_proxy_check toneAmber
class node_queue,node_segmented,node_video_finder,node_ytdlp toneMint
class node_database,node_logger toneRose
class node_http,node_ffmpeg,node_yt_dlp_project toneIndigo
```

## Components

### Application

- [Application Entry](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/persepolis.py): `persepolis/scripts/persepolis.py`
- [Main Window](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/mainwindow.py): `persepolis/scripts/mainwindow.py`
- [Main Window UI](https://github.com/persepolisdm/persepolis/blob/master/persepolis/gui/mainwindow_ui.py): `persepolis/gui/mainwindow_ui.py`
- [Settings](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/setting.py): `persepolis/scripts/setting.py`
- [Settings UI](https://github.com/persepolisdm/persepolis/blob/master/persepolis/gui/setting_ui.py): `persepolis/gui/setting_ui.py`
- [Progress View](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/progress.py): `persepolis/scripts/progress.py`
- [Completion Actions](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/after_download.py): `persepolis/scripts/after_download.py`

### Link Intake

- [Add Link](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/addlink.py): `persepolis/scripts/addlink.py`
- [Add Link UI](https://github.com/persepolisdm/persepolis/blob/master/persepolis/gui/addlink_ui.py): `persepolis/gui/addlink_ui.py`
- [Browser Integration](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/browser_integration.py): `persepolis/scripts/browser_integration.py`
- [Browser Link Queue](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/browser_plugin_queue.py): `persepolis/scripts/browser_plugin_queue.py`
- [Text Link Queue](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/text_queue.py): `persepolis/scripts/text_queue.py`
- [Link Inspection](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/spider.py): `persepolis/scripts/spider.py`
- [Proxy Check](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/check_proxy.py): `persepolis/scripts/check_proxy.py`

### Download Runtime

- [Download Queue](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/queue.py): `persepolis/scripts/queue.py`
- [Segmented Downloader](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/persepolis_lib_prime.py): `persepolis/scripts/persepolis_lib_prime.py`
- [Video Finder](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/video_finder.py): `persepolis/scripts/video_finder.py`
- [Video Downloader](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/ytdlp_downloader.py): `persepolis/scripts/ytdlp_downloader.py`

### State and Support

- [Download Database](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/data_base.py): `persepolis/scripts/data_base.py`
- [Logging](https://github.com/persepolisdm/persepolis/blob/master/persepolis/scripts/logger.py): `persepolis/scripts/logger.py`

### Other components

- **Desktop User**
- **HTTP Services**
- **FFmpeg**
- **yt-dlp**

## Connections

- Desktop User → Main Window: uses
- Application Entry → Main Window: starts (evidence: `persepolis/scripts/persepolis.py`)
- Application Entry → Download Database: initializes (evidence: `persepolis/scripts/persepolis.py`)
- Main Window → Main Window UI: uses (evidence: `persepolis/scripts/mainwindow.py`)
- Main Window → Add Link: invokes (evidence: `persepolis/scripts/mainwindow.py`)
- Main Window → Download Queue: dispatches (evidence: `persepolis/scripts/mainwindow.py`)
- Main Window → Video Finder: invokes (evidence: `persepolis/scripts/mainwindow.py`)
- Main Window → Settings: opens (evidence: `persepolis/scripts/mainwindow.py`)
- Main Window → Progress View: opens (evidence: `persepolis/scripts/mainwindow.py`)
- Main Window → Text Link Queue: opens (evidence: `persepolis/scripts/mainwindow.py`)
- Settings → Settings UI: uses (evidence: `persepolis/scripts/setting.py`)
- Add Link → Add Link UI: uses (evidence: `persepolis/scripts/addlink.py`)
- Add Link → Link Inspection: inspects links (evidence: `persepolis/scripts/addlink.py`)
- Add Link → Proxy Check: checks proxy (evidence: `persepolis/scripts/addlink.py`)
- Browser Integration → Browser Link Queue: submits links
- Browser Link Queue → Text Link Queue: uses (evidence: `persepolis/scripts/browser_plugin_queue.py`)
- Text Link Queue → Link Inspection: inspects links (evidence: `persepolis/scripts/text_queue.py`)
- Download Queue → Segmented Downloader: dispatches (evidence: `persepolis/scripts/queue.py`)
- Download Queue → Video Finder: dispatches (evidence: `persepolis/scripts/queue.py`)
- Download Queue → Video Downloader: dispatches (evidence: `persepolis/scripts/queue.py`)
- Video Finder → Video Downloader: uses (evidence: `persepolis/scripts/video_finder.py`)
- Segmented Downloader → HTTP Services: requests data (evidence: `persepolis/scripts/persepolis_lib_prime.py`)
- Video Downloader → yt-dlp: uses (evidence: `README.md`)
- Video Finder → FFmpeg: merges media (evidence: `README.md`)
- Main Window → Download Database: reads and writes (evidence: `persepolis/scripts/mainwindow.py`)
- Download Queue → Download Database: updates state
- Main Window → Logging: logs events (evidence: `persepolis/scripts/mainwindow.py`)
- Add Link → Logging: logs events (evidence: `persepolis/scripts/addlink.py`)
- Download Queue → Logging: logs events (evidence: `persepolis/scripts/queue.py`)
- Main Window → Completion Actions: runs completion (evidence: `persepolis/scripts/mainwindow.py`)
- Settings → Browser Integration: configures integration (evidence: `persepolis/scripts/setting.py`)
