# amir1376/ab-download-manager architecture

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

- Interactive diagram: https://gitdiagram.com/amir1376/ab-download-manager
- Repository: https://github.com/amir1376/ab-download-manager

## Overview

AB Download Manager is a cross-platform download manager. The principal workflow is a user adding a URL, managing the resulting download from the app, and relying on the download engine to process it; queues, browser integration, and scheduling are additional product capabilities. The tree and excerpts support the engine’s HTTP, queue, monitoring, and persistence components, but do not show most UI-to-engine wiring, so those links are omitted or marked unverified rather than presented as observed calls.

Main entry points: [`downloader/core/src/commonMain/kotlin/ir/amirab/downloader/DownloadManager.kt`](https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/DownloadManager.kt) (Download Manager), [`android/app/src/main/kotlin/com/abdownloadmanager/android/pages/add/single/AddSingleDownloadPage.kt`](https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/pages/add/single/AddSingleDownloadPage.kt) (Add Download), [`downloader/core/src/commonMain/kotlin/ir/amirab/downloader/db/DownloadListFileStorage.kt`](https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/db/DownloadListFileStorage.kt) (Download Records), [`android/app/src/main/kotlin/com/abdownloadmanager/android/ui/MainActivity.kt`](https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/ui/MainActivity.kt) (Android App Shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_android_main["Android App Shell<br/>[MainActivity.kt]"]
  node_desktop_app["Desktop App<br/>[App.kt]"]
  node_add_download["Add Download"]
  node_home["Download Home<br/>[HomePage.kt]"]
  node_browser["In-App Browser<br/>[BrowserUi.kt]"]
  node_settings["App Settings"]
end

subgraph group_engine["Download Engine"]
  node_manager["Download Manager<br/>[DownloadManager.kt]"]
  node_http["HTTP Downloader"]
  node_queues["Queue Manager<br/>[QueueManager.kt]"]
  node_monitor["Download Monitor<br/>[DownloadMonitor.kt]"]
end

subgraph group_state["Persistent State"]
  node_download_store[("Download Records")]
  node_queue_store[("Queue Records")]
  node_extra_settings[("Download Settings")]
end

subgraph group_platform["Platform Services"]
  node_android_service["Download Service"]
  node_notifications["Notifications"]
end

node_user(("User"))
node_extension["Browser Extension"]

node_user -->|"uses app"| node_android_main
node_user -->|"uses app"| node_desktop_app
node_user -.->|"adds URL"| node_add_download
node_add_download -.->|"submits download"| node_manager
node_manager -.->|"downloads data"| node_http
node_manager -.->|"uses queues"| node_queues
node_manager -.->|"persists records"| node_download_store
node_manager -.->|"reports progress"| node_monitor
node_home -.->|"manages downloads"| node_manager
node_browser -.->|"captures downloads"| node_add_download
node_extension -.->|"integrates with"| node_android_main
node_android_service -->|"uses notifications"| node_notifications
node_download_store -.->|"stores separately"| node_extra_settings

click node_android_main "https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/ui/MainActivity.kt"
click node_desktop_app "https://github.com/amir1376/ab-download-manager/blob/master/desktop/app/src/main/kotlin/com/abdownloadmanager/desktop/App.kt"
click node_add_download "https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/pages/add/single/AddSingleDownloadPage.kt"
click node_home "https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/pages/home/HomePage.kt"
click node_browser "https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/pages/browser/BrowserUi.kt"
click node_settings "https://github.com/amir1376/ab-download-manager/blob/master/shared/app/src/commonMain/kotlin/com/abdownloadmanager/shared/storage/appsettings/BaseAppSettingsStorage.kt"
click node_manager "https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/DownloadManager.kt"
click node_http "https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/connection/OkHttpHttpDownloaderClient.kt"
click node_queues "https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/queue/QueueManager.kt"
click node_monitor "https://github.com/amir1376/ab-download-manager/blob/master/downloader/monitor/src/commonMain/kotlin/ir/amirab/downloader/monitor/DownloadMonitor.kt"
click node_download_store "https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/db/DownloadListFileStorage.kt"
click node_queue_store "https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/db/QueueFileStorage.kt"
click node_extra_settings "https://github.com/amir1376/ab-download-manager/blob/master/shared/app/src/commonMain/kotlin/com/abdownloadmanager/shared/storage/ExtraDownloadSettingsStorage.kt"
click node_android_service "https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/service/DownloadSystemService.kt"
click node_notifications "https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/util/ABDMServiceNotificationManager.kt"

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_android_main,node_desktop_app,node_add_download,node_home,node_browser,node_settings,node_user,node_extension toneBlue
class node_manager,node_http,node_queues,node_monitor toneAmber
class node_download_store,node_queue_store,node_extra_settings toneMint
class node_android_service,node_notifications toneRose
```

## Components

### Application UI

- [Android App Shell](https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/ui/MainActivity.kt): `android/app/src/main/kotlin/com/abdownloadmanager/android/ui/MainActivity.kt`
- [Desktop App](https://github.com/amir1376/ab-download-manager/blob/master/desktop/app/src/main/kotlin/com/abdownloadmanager/desktop/App.kt): `desktop/app/src/main/kotlin/com/abdownloadmanager/desktop/App.kt`
- [Add Download](https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/pages/add/single/AddSingleDownloadPage.kt): `android/app/src/main/kotlin/com/abdownloadmanager/android/pages/add/single/AddSingleDownloadPage.kt`
- [Download Home](https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/pages/home/HomePage.kt): `android/app/src/main/kotlin/com/abdownloadmanager/android/pages/home/HomePage.kt`
- [In-App Browser](https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/pages/browser/BrowserUi.kt): `android/app/src/main/kotlin/com/abdownloadmanager/android/pages/browser/BrowserUi.kt`
- [App Settings](https://github.com/amir1376/ab-download-manager/blob/master/shared/app/src/commonMain/kotlin/com/abdownloadmanager/shared/storage/appsettings/BaseAppSettingsStorage.kt): `shared/app/src/commonMain/kotlin/com/abdownloadmanager/shared/storage/appsettings/BaseAppSettingsStorage.kt`

### Download Engine

- [Download Manager](https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/DownloadManager.kt): `downloader/core/src/commonMain/kotlin/ir/amirab/downloader/DownloadManager.kt`
- [HTTP Downloader](https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/connection/OkHttpHttpDownloaderClient.kt): `downloader/core/src/commonMain/kotlin/ir/amirab/downloader/connection/OkHttpHttpDownloaderClient.kt`
- [Queue Manager](https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/queue/QueueManager.kt): `downloader/core/src/commonMain/kotlin/ir/amirab/downloader/queue/QueueManager.kt`
- [Download Monitor](https://github.com/amir1376/ab-download-manager/blob/master/downloader/monitor/src/commonMain/kotlin/ir/amirab/downloader/monitor/DownloadMonitor.kt): `downloader/monitor/src/commonMain/kotlin/ir/amirab/downloader/monitor/DownloadMonitor.kt`

### Persistent State

- [Download Records](https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/db/DownloadListFileStorage.kt): `downloader/core/src/commonMain/kotlin/ir/amirab/downloader/db/DownloadListFileStorage.kt`
- [Queue Records](https://github.com/amir1376/ab-download-manager/blob/master/downloader/core/src/commonMain/kotlin/ir/amirab/downloader/db/QueueFileStorage.kt): `downloader/core/src/commonMain/kotlin/ir/amirab/downloader/db/QueueFileStorage.kt`
- [Download Settings](https://github.com/amir1376/ab-download-manager/blob/master/shared/app/src/commonMain/kotlin/com/abdownloadmanager/shared/storage/ExtraDownloadSettingsStorage.kt): `shared/app/src/commonMain/kotlin/com/abdownloadmanager/shared/storage/ExtraDownloadSettingsStorage.kt`

### Platform Services

- [Download Service](https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/service/DownloadSystemService.kt): `android/app/src/main/kotlin/com/abdownloadmanager/android/service/DownloadSystemService.kt`
- [Notifications](https://github.com/amir1376/ab-download-manager/blob/master/android/app/src/main/kotlin/com/abdownloadmanager/android/util/ABDMServiceNotificationManager.kt): `android/app/src/main/kotlin/com/abdownloadmanager/android/util/ABDMServiceNotificationManager.kt`

### Other components

- **User**
- **Browser Extension**

## Connections

- User → Android App Shell: uses app (evidence: `README.md`)
- User → Desktop App: uses app (evidence: `README.md`)
- User → Add Download: adds URL
- Add Download → Download Manager: submits download
- Download Manager → HTTP Downloader: downloads data
- Download Manager → Queue Manager: uses queues
- Download Manager → Download Records: persists records
- Download Manager → Download Monitor: reports progress
- Download Home → Download Manager: manages downloads
- In-App Browser → Add Download: captures downloads
- Browser Extension → Android App Shell: integrates with (evidence: `README.md`)
- Download Service → Notifications: uses notifications (evidence: `android/app/src/main/kotlin/com/abdownloadmanager/android/service/DownloadSystemService.kt`)
- Download Records → Download Settings: stores separately
