Environment Setup
Install dependencies, start the desktop app and browser extension.
Prerequisites
- Python ≥ 3.11 (project defaults to 3.11)
- uv package manager
- Node.js ≥ 18 (only required when modifying the extension)
Desktop
Clone the repository
git clone https://github.com/XiaoYouChR/Ghost-Downloader-3.git
cd Ghost-Downloader-3Install dependencies
uv syncBrowser Extension
Install dependencies
cd browser_extension/app
npm installLoad into the browser
Chrome → chrome://extensions → enable Developer mode → Load unpacked → select browser_extension/chromium/.
Common Issues
| Symptom | Check |
|---|---|
| UI won't start | Whether PySide6 is installed, whether the graphics environment is available, check logs |
| FeaturePack missing | Whether the features/<pack>/ directory is complete, check startup logs |
| Extension can't connect to the desktop | Whether the desktop extension switch is enabled, whether the port is occupied |