How camboas/camdown works
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: app.py Flask API · fb_downloader.py Downloader · fb_downloader_gui.py Desktop GUI · content.js Browser extension
Components 14
User interfaces
- CLI
fb_downloader.py - Desktop GUI
fb_downloader_gui.py - Browser extension
browser-extension/content.js - Web UI
webapp/templates/index.html - Web client logic
webapp/static/app.js - PWA service worker
webapp/static/sw.js
Download core
- Downloader
fb_downloader.py
Web service
- Flask API
webapp/app.py - Tray server
camdown_server.py - Download jobs
webapp/app.py
Settings
- Shared settings
config.py
Other components
- User
- Browser video page
- Video platforms
Connections 21
- User → CLI: submits URL
fb_downloader.py - User → Desktop GUI: provides link
fb_downloader_gui.py - User → Web UI: provides link
- Browser video page → Browser extension: shows video
browser-extension/content.js - Browser extension → Flask API: starts job
browser-extension/content.js - Browser extension → Flask API: polls status
browser-extension/content.js - Web UI → Web client logic: uses client logic
- Web client logic → Flask API: requests download
webapp/static/app.js - Web client logic → Flask API: polls status
webapp/static/app.js - Flask API → Download jobs: starts job
webapp/app.py - Flask API → Shared settings: loads and saves
webapp/app.py - Download jobs → Downloader: downloads
webapp/app.py - Flask API → Download jobs: serves status
webapp/app.py - Flask API → Download jobs: serves file
webapp/app.py - Tray server → Flask API: runs app
camdown_server.py - Desktop GUI → Downloader: downloads
fb_downloader_gui.py - Desktop GUI → Shared settings: loads and saves
fb_downloader_gui.py - CLI → Downloader: downloads
fb_downloader.py - Downloader → Shared settings: reads settings
fb_downloader.py - Downloader → Video platforms: extracts media
fb_downloader.py - Downloader → PWA service worker: not connected