How xiaoyouchr/ghost-downloader-3 works
Ghost Downloader is a cross-platform download manager with a Python desktop engine, Android client, protocol/feature packs, and a browser extension. The main workflow is to submit a URL or captured browser resource, parse it through the feature-pack system, create and manage a task, then download and present progress. The graph also preserves documented protocol breadth, browser capture, settings, and aria2-compatible RPC. Some pack, Android, and extension wiring is documented but not shown in sampled implementation; those links cite the README, and unsampled internals are represented at supported paths.
Main entry points: task_service.py Task service · engine.py Engine orchestrator · feature_service.py Feature service · background.ts Browser extension
Components 19
Intake and clients
- Browser extension
browser_extension/app/src/background.ts - Desktop app
app/platform/application.py - Android app
android/app/src/main/java/com/xychr/ghostdownloader/MainActivity.kt - aria2 RPC
app/services/aria2_rpc.py - Browser service
app/services/browser_service.py
Download engine
- Engine orchestrator
app/engine.py - Feature service
app/services/feature_service.py - Task service
app/services/task_service.py - Task model
app/models/task.py
Protocols and packs
- HTTP downloads
features/http_pack/task.py - Feature packs
app/models/pack.py - Media and protocol packs
features
User experience
- Task interface
app/view/pages/task_page.py - Android interface
android/app/src/main/java/com/xychr/ghostdownloader/ui/pages/TasksPage.kt - Extension popup
browser_extension/app/src/popup/App.tsx - Configuration
app/config/cfg.py
Platform services
- File operations
app/platform/filesystem.py - App data paths
app/config/paths.py
Other components
- Downloader user
Connections 24
- Downloader user → Desktop app: submits links
README.md - Downloader user → Android app: submits links
README.md - Downloader user → Browser extension: captures media
README.md - Desktop app → Engine orchestrator: starts engine
- Android app → Engine orchestrator: uses download engine
- Browser extension → Browser service: sends resources
README.md - Browser service → Feature service: parses resources
app/engine.py - aria2 RPC → Feature service: parses requests
app/engine.py - Engine orchestrator → Feature service: activates
app/engine.py - Engine orchestrator → Task service: starts and stops
app/engine.py - Feature service → Task service: creates tasks
- Task service → Task model: manages tasks
app/services/task_service.py - Task service → File operations: deletes files
app/services/task_service.py - HTTP downloads → Task model: implements task steps
features/http_pack/task.py - Feature packs → Media and protocol packs: loads packs
features/bittorrent_pack/config.py - Media and protocol packs → Task service: provides download tasks
- Downloader user → Task interface: manages downloads
README.md - Downloader user → Android interface: manages downloads
README.md - Browser extension → Extension popup: shows captured media
- Task interface → Task service: controls tasks
- Android interface → Task service: controls tasks
- Configuration → Engine orchestrator: configures services
app/engine.py - Task service → App data paths: persists task state
app/services/task_service.py - Downloader user → aria2 RPC: submits RPC requests
README.md