简体中文 | English

AI-powered next-generation cross-platform multithreaded downloader

Documentation · Report Bug · Request Feature

Features

• IDM-style intelligent chunking⚡ without requiring file merging, plus AI smart acceleration 🚀
• Frees UI resources when minimized to tray🍃 — minimal memory footprint in the background
• Supports HTTP, Magnet / BT, FTP, M3U8, MPEG-DASH, eD2k and more 🌐
• Emulates real-browser TLS fingerprints🥷 so downloads are less likely to be blocked by anti-bot checks
• Parses YouTube▶️ and Bilibili videos — playlists, up to 4K/HDR, subtitles and login supported
• Dedicated parsers for GitHub🐙 releases and HuggingFace🤗 models with mirror acceleration
• Records M3U8 live streams📺 with real-time decryption🔓, fully supported on Android as well
• The companion browser extension🦊 sniffs page media, takes over browser downloads, and controls tasks without leaving the browser
• aria2-compatible RPC interface🔌 — third-party tools can push tasks directly
• Tasks can be paused, edited✏️ (URL, headers, proxy) and resumed without losing progress
• A complete Android version📱 with background downloading and completion notifications 🔔

About The Project

• A downloader built out of passion, and my first Python project 😣
• It was originally created to help a Bilibili creator integrate resources 😵‍💫
• Thanks to Python's🐍 accessibility, this project will open plugin🧩 support in the future (plugin API is still being stabilized...)

Platform	Required Version	Architectures	Compatible
🐧 Linux	glibc 2.35+	x86_64/arm64	✅
🪟 Windows	10+	x86_64/arm64	✅
🍎 macOS	13.0+	x86_64/arm64	✅
🤖 Android	10.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

Roadmap

• ❌ Make the plugin API public
• ❌ Enhanced task editing (powerful features like binding multiple Sessions to one task)

Visit Open issues to see all requested features (and known issues).

Sponsor

	Free code signing provided by SignPath.io, with certificates by SignPath Foundation

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 © 2024-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
• goed2k The eD2k download daemon 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 created the project banner.