Ghost-Downloader-3 README

The project's README from github.com/XiaoYouChR/Ghost-Downloader-3. As one markdown file: README.md.

简体中文 | English

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

Banner

XiaoYouChR%2FGhost-Downloader-3 | Trendshift

The only downloader you need

Forks Stargazers Issues Release Downloads QQGroup Discord

Documentation · Report Bug · Request Feature

Features

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 11.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

Demo

Roadmap

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

Sponsor

Logo Description
SignPath Free code signing provided by SignPath.io, with certificates by SignPath Foundation
i0ntempest 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!

Contributors

Translation Contributors

[!TIP] If you'd like to help translate Ghost Downloader, welcome to join the Crowdin project: ghost-downloader

logo
XiaoYouChR

14249 words
logo
i0ntempest

1988 words
logo
ReM2812

1010 words
logo
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

References

Acknowledgments

Star History

Star History Chart

Ghost-Downloader-3 (XiaoYouChR/Ghost-Downloader-3)

Searching Database…

What is this?Ghost Downloader is a cross-platform desktop download manager that handles HTTP, BitTorrent/Magnet, FTP, M3U8, MPEG-DASH and eD2k links, plus video sites like YouTube and Bilibili, all in one app.
Is it a standalone app or a library I'd embed?It is a standalone native desktop GUI application built with PySide6/Qt and the Fluent Design widget library, not a library or CLI tool.
How do I get it running?Download the prebuilt build for your OS from the project's releases (Windows 10+, macOS 13.0+, Linux glibc 2.35+, or Android 11.0+) and install it; both x86-64 and arm64 builds are provided.
Do I need anything special on my machine first?Qt 6.6+ requires a CPU with the AVX instruction set, and Linux builds need glibc 2.35 or newer; an optional browser extension is needed if you want to sniff and grab media straight from web pages.
Any rough edges right now?The Feature Packs plugin system already works but its public API is still being stabilized, so you can't yet build third-party plugins against a finalized interface.
What protocols and sites can it actually pull from?It covers HTTP, Magnet/BitTorrent, FTP, M3U8, MPEG-DASH and eD2k downloads, plus dedicated support for YouTube and Bilibili (with clip, quality, subtitle and playlist selection) and mirror-accelerated GitHub/HuggingFace downloads.
How does the companion browser extension work?It scans the current page for every downloadable medium, shows them in a popup, and when you click one (or download normally) the desktop app takes over seamlessly, carrying over your login session so you never copy links.
Can other tools control my downloads programmatically?Yes, Ghost Downloader exposes an aria2-compatible RPC API so third-party apps and scripts can create and manage download tasks.
Is there a plugin ecosystem?Yes, it has a growing 'Feature Packs' plugin system that is already operational, though the public plugin API is still being finalized.
Creator
XiaoYouChR
Size
64.6 MB
Stars
10K
Age
3y
Commits · 90 Days