# camboas/camdown architecture

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

- Interactive diagram: https://gitdiagram.com/camboas/camdown
- Repository: https://github.com/camboas/camdown

## Overview

CAMDOWN downloads videos from Facebook, YouTube, TikTok, Instagram, and Pinterest through CLI, desktop, web, or browser-extension entry points. Each request is handled by the shared yt-dlp downloader, which organizes results by platform and supports TikTok profile batches, quality selection, progress hooks, cookies, and FFmpeg post-processing. The web API runs jobs asynchronously and exposes status and file retrieval; the extension uses that local API. Settings are shared across interfaces. Source excerpts support the core calls and API flow; some UI and CLI details are inferred only from the tree or module documentation.

Main entry points: [`webapp/app.py`](https://github.com/camboas/camdown/blob/main/webapp/app.py) (Flask API), [`fb_downloader.py`](https://github.com/camboas/camdown/blob/main/fb_downloader.py) (Downloader), [`fb_downloader_gui.py`](https://github.com/camboas/camdown/blob/main/fb_downloader_gui.py) (Desktop GUI), [`browser-extension/content.js`](https://github.com/camboas/camdown/blob/main/browser-extension/content.js) (Browser extension)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["CLI<br/>[fb_downloader.py]"]
  node_desktop["Desktop GUI"]
  node_extension["Browser extension<br/>[content.js]"]
  node_webui["Web UI<br/>[index.html]"]
  node_webclient["Web client logic<br/>[app.js]"]
  node_pwa["PWA service worker<br/>[sw.js]"]
end

subgraph group_download["Download core"]
  node_engine["Downloader<br/>[fb_downloader.py]"]
end

subgraph group_server["Web service"]
  node_api["Flask API<br/>[app.py]"]
  node_tray["Tray server<br/>[camdown_server.py]"]
  node_jobs["Download jobs<br/>[app.py]"]
end

subgraph group_settings["Settings"]
  node_config["Shared settings<br/>[config.py]"]
end

node_user(("User"))
node_browser(("Browser video page"))
node_platforms(("Video platforms"))

node_user -.->|"submits URL"| node_cli
node_user -.->|"provides link"| node_desktop
node_user -.->|"provides link"| node_webui
node_browser -.->|"shows video"| node_extension
node_extension -->|"starts job"| node_api
node_extension -->|"polls status"| node_api
node_webui -.->|"uses client logic"| node_webclient
node_webclient -->|"requests download"| node_api
node_webclient -->|"polls status"| node_api
node_api -->|"starts job"| node_jobs
node_api -->|"loads and saves"| node_config
node_jobs -->|"downloads"| node_engine
node_api -->|"serves status"| node_jobs
node_api -->|"serves file"| node_jobs
node_tray -->|"runs app"| node_api
node_desktop -->|"downloads"| node_engine
node_desktop -->|"loads and saves"| node_config
node_cli -->|"downloads"| node_engine
node_engine -->|"reads settings"| node_config
node_engine -->|"extracts media"| node_platforms
node_engine -.->|"not connected"| node_pwa

click node_cli "https://github.com/camboas/camdown/blob/main/fb_downloader.py"
click node_desktop "https://github.com/camboas/camdown/blob/main/fb_downloader_gui.py"
click node_extension "https://github.com/camboas/camdown/blob/main/browser-extension/content.js"
click node_webui "https://github.com/camboas/camdown/blob/main/webapp/templates/index.html"
click node_webclient "https://github.com/camboas/camdown/blob/main/webapp/static/app.js"
click node_api "https://github.com/camboas/camdown/blob/main/webapp/app.py"
click node_tray "https://github.com/camboas/camdown/blob/main/camdown_server.py"
click node_jobs "https://github.com/camboas/camdown/blob/main/webapp/app.py"
click node_engine "https://github.com/camboas/camdown/blob/main/fb_downloader.py"
click node_config "https://github.com/camboas/camdown/blob/main/config.py"
click node_pwa "https://github.com/camboas/camdown/blob/main/webapp/static/sw.js"

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_cli,node_desktop,node_extension,node_webui,node_webclient,node_pwa,node_user,node_browser toneBlue
class node_engine toneAmber
class node_api,node_tray,node_jobs toneMint
class node_config toneRose
class node_platforms toneIndigo
```

## Components

### User interfaces

- [CLI](https://github.com/camboas/camdown/blob/main/fb_downloader.py): `fb_downloader.py`
- [Desktop GUI](https://github.com/camboas/camdown/blob/main/fb_downloader_gui.py): `fb_downloader_gui.py`
- [Browser extension](https://github.com/camboas/camdown/blob/main/browser-extension/content.js): `browser-extension/content.js`
- [Web UI](https://github.com/camboas/camdown/blob/main/webapp/templates/index.html): `webapp/templates/index.html`
- [Web client logic](https://github.com/camboas/camdown/blob/main/webapp/static/app.js): `webapp/static/app.js`
- [PWA service worker](https://github.com/camboas/camdown/blob/main/webapp/static/sw.js): `webapp/static/sw.js`

### Download core

- [Downloader](https://github.com/camboas/camdown/blob/main/fb_downloader.py): `fb_downloader.py`

### Web service

- [Flask API](https://github.com/camboas/camdown/blob/main/webapp/app.py): `webapp/app.py`
- [Tray server](https://github.com/camboas/camdown/blob/main/camdown_server.py): `camdown_server.py`
- [Download jobs](https://github.com/camboas/camdown/blob/main/webapp/app.py): `webapp/app.py`

### Settings

- [Shared settings](https://github.com/camboas/camdown/blob/main/config.py): `config.py`

### Other components

- **User**
- **Browser video page**
- **Video platforms**

## Connections

- User → CLI: submits URL (evidence: `fb_downloader.py`)
- User → Desktop GUI: provides link (evidence: `fb_downloader_gui.py`)
- User → Web UI: provides link
- Browser video page → Browser extension: shows video (evidence: `browser-extension/content.js`)
- Browser extension → Flask API: starts job (evidence: `browser-extension/content.js`)
- Browser extension → Flask API: polls status (evidence: `browser-extension/content.js`)
- Web UI → Web client logic: uses client logic
- Web client logic → Flask API: requests download (evidence: `webapp/static/app.js`)
- Web client logic → Flask API: polls status (evidence: `webapp/static/app.js`)
- Flask API → Download jobs: starts job (evidence: `webapp/app.py`)
- Flask API → Shared settings: loads and saves (evidence: `webapp/app.py`)
- Download jobs → Downloader: downloads (evidence: `webapp/app.py`)
- Flask API → Download jobs: serves status (evidence: `webapp/app.py`)
- Flask API → Download jobs: serves file (evidence: `webapp/app.py`)
- Tray server → Flask API: runs app (evidence: `camdown_server.py`)
- Desktop GUI → Downloader: downloads (evidence: `fb_downloader_gui.py`)
- Desktop GUI → Shared settings: loads and saves (evidence: `fb_downloader_gui.py`)
- CLI → Downloader: downloads (evidence: `fb_downloader.py`)
- Downloader → Shared settings: reads settings (evidence: `fb_downloader.py`)
- Downloader → Video platforms: extracts media (evidence: `fb_downloader.py`)
- Downloader → PWA service worker: not connected
