简体中文 | English

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

![Banner](.github/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) [![Discord](https://img.shields.io/discord/1527965717973176391?style=for-the-badge&logo=discord&logoColor=white&label=Discord&color=%235865F2)](https://discord.gg/fKfhkPumEM) ##### [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)

## 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 at IDM-level coverage with no quality cap, 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](https://github.com/zxp19821005)) ## Screenshots ![QQ20260326-204347](https://github.com/user-attachments/assets/3e57b113-200c-4286-91cb-b52fe7d1711c) ## Roadmap - ❌ Make the plugin API public - ❌ Enhanced task editing (powerful features like binding multiple Sessions to one task) 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 © 2024-2026 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 * [goed2k](https://github.com/monkeyWie/goed2k) The eD2k download daemon behind Ghost Downloader's eD2k support * [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 * [N_m3u8DL-RE](https://github.com/nilaoda/N_m3u8DL-RE) Cross-platform DASH/HLS/MSS download tool powering Ghost Downloader's M3U8 support * [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 * [QuickJS-NG](https://github.com/quickjs-ng/quickjs) A small and embeddable JavaScript engine * [uvloop](https://github.com/MagicStack/uvloop) Ultra fast asyncio event loop * [winloop](https://github.com/Vizonex/Winloop) An alternative to uvloop for Windows * [wreq](https://github.com/0x676e67/wreq-python) An ergonomic Python HTTP client with TLS fingerprint emulation * [yt-dlp](https://github.com/yt-dlp/yt-dlp) A feature-rich command-line audio/video downloader ## 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 [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