XiaoYouChR/Ghost-Downloader-3

简体中文 | English

[!TIP] Join the Ghost Downloader community on Discord: discord.gg/fKfhkPumEM

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. YouTube and Bilibili with clip selection, any quality and subtitles, playlists and multi-part episodes. GitHub and HuggingFace with 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
Windows	10+	x86_64 / arm64
macOS	13.0+	x86_64 / arm64
Linux	glibc 2.35+	x86_64 / arm64
Android	9.0+	arm64-v8a

[!WARNING] Qt 6.6+ no longer supports CPUs without the AVX instruction set.

[!TIP] Arch Linux AUR support: Community-maintained packages ghost-downloader-bin and ghost-downloader-git are now available (Maintainer: @zxp19821005)

Screenshots

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!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. 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

• E-mail - XiaoYouChR@qq.com

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