简体中文 | English

> [!NOTE] > Due to academic commitments, development on this project has slowed down recently.

![Banner](app/assets/banner.webp)

### AI-powered next-generation cross-platform multithreaded downloader [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![Release][release-shield]][release-url] [![Downloads][downloads-shield]][release-url] [![QQGroup](https://img.shields.io/badge/QQ_Group-756042420-blue.svg?color=blue&style=for-the-badge)](https://qm.qq.com/q/gPk6FR1Hby) ##### [Documentation](https://gd.xychr.com/en/docs/) · [Report Bug](https://github.com/XiaoYouChR/Ghost-Downloader-3/issues/new?template=bug_report.yml) · [Request Feature](https://github.com/XiaoYouChR/Ghost-Downloader-3/issues/new?template=feature_request.yml)

## 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** | `7 SP1+` | `x86_64`/`arm64` | ✅ | | 🍎 **macOS** | `13.0+` | `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](https://github.com/zxp19821005)) ## Features * IDM-style intelligent chunking⚡ without requiring file merging, plus AI smart acceleration 🚀 * Supports HTTP, Magnet / BT, FTP, M3U8, MPEG-DASH and more 🌐 * Records M3U8 live streams📺 with real-time decryption🔓, fully supported on Android as well * The companion browser extension🦊 sniffs media resources right off web pages * Tasks can be paused, edited✏️ (URL, headers, proxy) and resumed without losing progress * A complete Android version📱 with background downloading and completion notifications 🔔 ## Screenshots ![QQ20260326-204347](https://github.com/user-attachments/assets/3e57b113-200c-4286-91cb-b52fe7d1711c) ## Roadmap - ❌ Native download engine (lower memory usage while running in the background) - ❌ Make the plugin API public - ❌ Enhanced task editing (powerful features like binding multiple Sessions to one task) - ❌ Support for eD2k protocol Visit [Open issues](https://github.com/XiaoYouChR/Ghost-Downloader-3/issues) to see all requested features (and known issues). ## Sponsor | [![SignPath](https://signpath.org/assets/favicon-50x50.png)](https://signpath.org/) | Free code signing provided by [SignPath.io](https://about.signpath.io/), with certificates by [SignPath Foundation](https://signpath.org/) | |-------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------| ## 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! [![Contributors](http://contrib.nn.ci/api?repo=XiaoYouChR/Ghost-Downloader-3)](https://github.com/XiaoYouChR/Ghost-Downloader-3/graphs/contributors) ## Translation Contributors > [!TIP] > If you'd like to help translate Ghost Downloader, welcome to join the Crowdin project: [ghost-downloader](https://crowdin.com/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 © 2025 XiaoYouChR. ## Contact > [!IMPORTANT] > Welcome to join the Ghost Downloader user group: [756042420](https://qm.qq.com/q/gPk6FR1Hby) * [E-mail](mailto:XiaoYouChR@qq.com) - XiaoYouChR@qq.com ## References * [aioftp](https://github.com/aio-libs/aioftp) Ftp client/server for asyncio * [cat-catch](https://github.com/xifangczy/cat-catch) Browser Resource Sniffing Extension * [desktop-notifier](https://github.com/samschott/desktop-notifier) Python library for cross-platform desktop notifications * [FFmpeg](https://ffmpeg.org/) A complete, cross-platform solution to record, convert and stream audio and video * [libtorrent](https://github.com/arvidn/libtorrent) An efficient feature complete C++ bittorrent implementation * [loguru](https://github.com/Delgan/loguru) A library which aims to bring enjoyable logging in Python * [m3u8](https://github.com/globocom/m3u8) Python m3u8 parser * [mpegdash](https://github.com/sangoma/mpegdash) MPEG-DASH MPD parser * [niquests](https://github.com/jawah/niquests) Automatic HTTP/1.1, HTTP/2, and HTTP/3. WebSocket, and SSE included. * [Nuitka](https://github.com/Nuitka/Nuitka) The Python compiler * [PyQt-Fluent-Widgets](https://github.com/zhiyiYo/PyQt-Fluent-Widgets) Powerful, extensible, and elegant Fluent Design-style widget library * [PySide6](https://github.com/PySide/pyside-setup) The official Python module * [uvloop](https://github.com/MagicStack/uvloop) Ultra fast asyncio event loop * [winloop](https://github.com/Vizonex/Winloop) An alternative to uvloop for Windows ## Acknowledgments * [@zhiyiYo](https://github.com/zhiyiYo/) is amazing and provided a lot of help for this project. * [@空糖_SuGar](https://github.com/SuGar0218/) created the project banner.

[forks-shield]: https://img.shields.io/github/forks/XiaoYouChR/Ghost-Downloader-3.svg?style=for-the-badge [forks-url]: https://github.com/XiaoYouChR/Ghost-Downloader-3/network/members [stars-shield]: https://img.shields.io/github/stars/XiaoYouChR/Ghost-Downloader-3.svg?style=for-the-badge [stars-url]: https://github.com/XiaoYouChR/Ghost-Downloader-3/stargazers [issues-shield]: https://img.shields.io/github/issues/XiaoYouChR/Ghost-Downloader-3.svg?style=for-the-badge [issues-url]: https://github.com/XiaoYouChR/Ghost-Downloader-3/issues [product-screenshot]: app/assets/screenshot.png [release-shield]: https://img.shields.io/github/v/release/XiaoYouChR/Ghost-Downloader-3?style=for-the-badge [release-url]: https://github.com/XiaoYouChR/Ghost-Downloader-3/releases/latest [downloads-shield]: https://img.shields.io/github/downloads/XiaoYouChR/Ghost-Downloader-3/total?style=for-the-badge