XiaoYouChR/Ghost-Downloader-3 — a trending Python project
The only downloader you need. 下载器的集大成者。
XiaoYouChR/Ghost-Downloader-3 — Python · 12,288 stars · 777 forks · +432 today
The only downloader you need. 下载器的集大成者。
[!NOTE]
Swiftproxy – Premium Global Residential Proxy Network Swiftproxy provides 90M+ real residential IPs across 220+ locations worldwide, helping users access global content and manage location-specific network connections. With rotating and static residential proxies, flexible geo-targeting, and HTTP(S)/SOCKS5 support, Swiftproxy is ideal for cross-region downloads, network testing, and browser automation. Free testing available, with 10% off using code
PROXY90.
Features
#- Fast where it matters. Every downloader is fast on a good connection. The real test is a bad one. Smart chunking without file merging. Auto-detects bandwidth. Real-browser TLS fingerprints, invisible to anti-bot checks.
- One app instead of five. Everything in one place, nothing watered down.
HTTP,Magnet/BT,FTP,M3U8,MPEG-DASH,eD2k.YouTubeandBilibiliwith clip selection, any quality and subtitles, playlists and multi-part episodes.GitHubandHuggingFacewith mirror acceleration. - See it. Sniff it. Download it. A download button follows the video, any quality you want. The extension popup lists every medium on the page. Click it there, or just download as you normally would, the desktop app takes over seamlessly. No copying links, and authentication state carries over.
- Native on every platform. It shows in the details. One app, four systems, native experience everywhere. On Android, it records live M3U8 streams and keeps downloading in the background.
- Always in control Effortlessly.
aria2-compatible RPC API for third-party tools. Change the URL, headers, or proxy mid-download. Progress is never lost.
About The Project
#Started as a passion project to help a Bilibili creator manage resources. Now it ships on four platforms, handles virtually every download protocol, and has a growing Feature Packs plugin ecosystem.
| Platform | Required Version | Architectures |
|---|---|---|
10+ |
x86_64 / arm64 |
|
13.0+ |
x86_64 / arm64 |
|
glibc 2.35+ |
x86_64 / arm64 |
|
9.0+ |
arm64-v8a |
[!WARNING] Qt
6.6+no longer supports CPUs without theAVXinstruction set.
[!TIP] Arch Linux AUR support: Community-maintained packages
ghost-downloader-binandghost-downloader-gitare now available (Maintainer: @zxp19821005)
Screenshots
#https://github.com/user-attachments/assets/d97dc8c9-f320-4645-8dcd-0d9dc4cf2eab
Command Line
#Install ghd from Settings -> Command Line Tool.
| Command | Description |
|---|---|
ghd probe <url> |
Preview a URL without adding a task |
ghd add <url>... |
Add and start tasks |
ghd tasks |
List tasks |
ghd task <taskId> |
Show task details |
ghd pause <taskId>... |
Pause tasks |
ghd start <taskId>... |
Resume tasks |
ghd remove <taskId>... |
Remove tasks and delete unfinished files |
ghd wait <taskId>... |
Wait for tasks to finish |
# see which files the torrent contains
ghd probe "https://example.com/a.torrent"
# download only files 0 and 3 into ./downloads
ghd add "https://example.com/a.torrent" --select 0,3 -o ./downloads
# wait until the download finishes
ghd wait tsk_0123
Roadmap
#- Make the plugin API public (Feature Packs system is operational, API stabilizing)
- Enhanced task editing, such as binding multiple Sessions to one task
Visit Open issues to see all requested features (and known issues).
Sponsor
#| Logo | Description |
|---|---|
| Free code signing provided by SignPath.io, with certificates by SignPath Foundation | |
![]() |
Free code signing provided by i0ntempest.com |
Contributing
#Contributions make the open source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion, fork the repo and create a pull request. You can also simply open an issue with the "Enhancement" tag. Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (git checkout -b feature/AmazingFeature)
- Commit your Changes (git commit -m 'Add some AmazingFeature')
- Push to the Branch (git push origin feature/AmazingFeature)
- Open a Pull Request
Thanks to all contributors who have participated in this project!
Translation Contributors
#[!TIP] If you'd like to help translate Ghost Downloader, welcome to join the Crowdin project: ghost-downloader
|
XiaoYouChR 14249 words |
i0ntempest 1988 words |
ReM2812 1010 words |
Dima88888 115 words |
License
#Distributed under the GPL v3.0 License. Open LICENSE for more details.
Copyright © 2023-2026 XiaoYouChR.
Contact
#[!IMPORTANT] Welcome to join the Ghost Downloader user group: 756042420
References
#- aioftp Ftp client/server for asyncio
- cat-catch Browser Resource Sniffing Extension
- desktop-notifier Python library for cross-platform desktop notifications
- FFmpeg A complete, cross-platform solution to record, convert and stream audio and video
- Kelpie The eD2k download engine behind Ghost Downloader's eD2k support
- libtorrent An efficient feature complete C++ bittorrent implementation
- loguru A library which aims to bring enjoyable logging in Python
- m3u8 Python m3u8 parser
- mpegdash MPEG-DASH MPD parser
- N_m3u8DL-RE Cross-platform DASH/HLS/MSS download tool powering Ghost Downloader's M3U8 support
- Nuitka The Python compiler
- PyQt-Fluent-Widgets Powerful, extensible, and elegant Fluent Design-style widget library
- PySide6 The official Python module
- QuickJS-NG A small and embeddable JavaScript engine
- uvloop Ultra fast asyncio event loop
- winloop An alternative to uvloop for Windows
- wreq An ergonomic Python HTTP client with TLS fingerprint emulation
- yt-dlp A feature-rich command-line audio/video downloader
Acknowledgments
#- @zhiyiYo is amazing and provided a lot of help for this project.
- @空糖_SuGar designed the project banner (the current version is a 3D remake based on the original design).
Star History
#Content above is the README of XiaoYouChR/Ghost-Downloader-3, reproduced from GitHub’s trending list. All rights remain with the original authors.
Newsletter
New posts in your inbox. Confirm by email, unsubscribe any time.
More in Python
View allTracer-Cloud/opensre — a trending Python project
The open-source agent for CI/CD reliability.
via GitHub · 1 min
jingyaogong/minimind — a trending Python project
🧠 Train a 64M-parameter LLM from scratch in just 2h!
via GitHub · 2 min
kajisho5/ffmpeg-skill — a trending Python project
Local video editor for coding agents: 42 FFmpeg tools with a machine-readable contract and an MCP server, for Claude Code, Cursor and Codex. Cut, captions, reframe, loudness, platform exports. No cloud, no API keys.
via GitHub · 6 min
google-research/paper-orchestra — a trending Python project
PaperOrchestra is a multi-agent framework for automated AI research paper writing.
via GitHub · 1 min



Comments
Posting as a guest