Getting Started
Setup and Run
Install dependencies, start the desktop app, and build the browser extension.
Install desktop dependencies.
cd C:\Users\XiaoYouChR\PycharmProjects\Ghost-Downloader-3
pip install --timeout=300 -r requirements.txtStart the desktop app from source.
python Ghost-Downloader-3.pyIf you are changing the browser extension, install and build it too.
cd browser_extension\app
npm install
npm run typecheck
npm run buildWhat Happens on Startup
The entry file loads UserConfig.json, starts coreService, creates MainWindow, loads features/*_pack, and restores memorized tasks through taskRecorder. For a silent startup without the splash screen:
python Ghost-Downloader-3.py --silenceCommon Blockers
| Symptom | Check First |
|---|---|
| UI does not launch | PySide6, Qt plugins, graphics environment, and log files. |
| Feature Packs are missing | features/<pack>/manifest.toml, dependencies, and pack loading logs. |
| Extension cannot connect | Desktop extension switch, ws://127.0.0.1:14370, and the pairing token. |