What is Ghost Downloader?
Ghost Downloader is a free, open-source download manager for Windows, macOS, Linux and Android, released under the GNU General Public License v3.0. It is developed by XiaoYouChR in the Ghost-Downloader-3 repository on GitHub; the website and the app use the name Ghost Downloader, and the current release line is 4.x. The README describes how it started as a personal project to help a Bilibili creator manage resources. It now handles HTTP and HTTPS, BitTorrent and magnet links, FTP, M3U8 (HLS), MPEG-DASH and eD2k in one application, and adds site-specific handling for YouTube, Bilibili, GitHub and Hugging Face.
The desktop app is written in Python with PySide6 (Qt 6) and the PyQt-Fluent-Widgets component library, runs its network work on asyncio (uvloop, or winloop on Windows) and is compiled to native binaries with Nuitka. Protocol support is organised as Feature Packs: separate modules for HTTP, FTP, M3U8, BitTorrent, eD2k, Bilibili, yt-dlp, GitHub, Hugging Face and FFmpeg merging. Several of them call external engines: libtorrent for BitTorrent, N_m3u8DL-RE for HLS and DASH, yt-dlp for YouTube, FFmpeg for muxing, and Kelpie, an eD2k engine by the same developer. The browser extension is a separate TypeScript project whose popup is built with React and Fluent UI React components; it also includes the media capture functions of the Cat Catch extension. The architecture overview documents the service layout, the task lifecycle and the JSONL task store.
Builds are published on GitHub Releases: setup and portable ZIP packages for Windows on x86_64 and arm64, DMG images for Intel and Apple silicon Macs, AppImage, .deb and .tar.xz archives for Linux on x86_64 and arm64, and an arm64-v8a APK for Android. The README lists Windows 10, macOS 13, glibc 2.35 and Android 9 as minimum versions, while the installation guide gives Android 10. The README warning states that Qt 6.6 and later no longer support CPUs without the AVX instruction set, and the installation guide adds that Windows 7 and pre-2011 processors without AVX are not supported. Free code signing is provided by SignPath.io with certificates from the SignPath Foundation, according to the README sponsor section.
The latest release, v4.5.11 of November 20, 2026, adds German, French, Indonesian, Italian and Korean translations and fixes an error that Windows reported every second when the taskbar does not support progress display. Its release notes also say that updates will come less often for a while because of the developer's studies. The release also attaches differential patch files from 4.5.8 for Windows and macOS alongside the full installers. Translations are managed on Crowdin with Simplified Chinese as the source language, and a language is added to the app once 60 percent of the desktop text is translated.
The README and the documentation are explicit about limits. Android builds leave out BitTorrent and eD2k; DRM-protected streams cannot be downloaded; live recordings cannot be paused and are saved as .ts files; and the aria2-compatible RPC service implements only two methods. Making the Feature Pack plugin API public is still on the roadmap. Ghost Downloader supports downloading from YouTube and Bilibili; users are responsible for complying with each site's terms and with copyright law. Similar tools listed on iThub include Internet Download Manager, SwiftDL and LibreGet.
Key capabilities
- Download for Windows Windows 10 or later on x86_64 or arm64. Each release has a
Setup.exeinstaller that writes to Program Files and creates shortcuts, and a portable ZIP that runs without registry changes and keeps its data in the program folder. The documentation notes that Windows 11 Smart App Control can block startup and that Windows Defender occasionally flags the Nuitka-compiled binaries; the portable ZIP and a Defender exclusion are the documented workarounds. Files are on the latest release page. - Download for macOS MacOS 13 or later, with separate DMG images for Apple silicon (arm64) and Intel (x86_64). The app is not notarized by Apple, so Gatekeeper blocks the first launch; the DMG contains a repair script, and the platform issues page gives the equivalent
xattr -crcommand. - Download for Linux Linux with glibc 2.35 or later on x86_64 or arm64, as a .deb package that installs to
/opt, an AppImage (some distributions needlibfuse2) or a .tar.xz archive. The README mentions community-maintained AUR packages,ghost-downloader-binandghost-downloader-git, which are not built by the project; the FAQ suggests the -git package where the bundled Qt of the -bin package conflicts with KDE. - Android app An arm64-v8a APK built from the same codebase as the desktop app; emulators are not supported. It keeps downloading in the background with a persistent notification, records live M3U8 streams, receives links and .torrent or .m3u8 files through the system share menu and can accept tasks from a paired browser extension. The Android page lists the missing features (BitTorrent, eD2k) and the storage, notification and battery permissions it asks for.
- Segmented HTTP and FTP downloads A Range probe decides between parallel chunks, single-threaded downloads and unknown-size mode. Chunks that finish take over half of the largest remaining chunk, and progress offsets are saved every second for resume. Preallocated threads range from 1 to 256 (default 8), and an automatic speed boost adds chunks while throughput keeps rising. FTP and FTPS links can also list a remote directory as a file tree.
- BitTorrent and magnet links Magnet links and .torrent files run on libtorrent, with file selection that can be changed at any time without losing downloaded parts. Seeding starts after completion and can be limited by share ratio or time in Settings. Only SOCKS5 proxies apply to BitTorrent download traffic.
- M3U8, MPEG-DASH and live recording HLS and DASH streams are handled through N_m3u8DL-RE. Live streams pasted as .m3u8 or .mpd links can be recorded with a quality choice and an optional duration limit; encrypted live streams are decrypted automatically. The live recording page states that recordings cannot be paused, are saved as .ts files and can miss segments after longer network interruptions.
- YouTube and Bilibili For YouTube, an installable yt-dlp runtime provides quality selection, subtitles saved as .vtt files, playlists and clip ranges. Bilibili supports multi-part videos, subtitles and covers, with QR code login or cookie import for higher qualities. The site notes describe each site's requirements. Users are responsible for complying with the terms of these sites and with copyright when downloading.
- eD2k links Ghost Downloader opens
ed2k://links through the Kelpie engine, which is installed as a separate runtime from Settings. The protocol can be registered as a URI scheme on Windows and Linux. eD2k is not available on Android. - GitHub and Hugging Face acceleration An optional GitHub accelerator routes release downloads through built-in mirror sites such as gh-proxy.com and ghfast.top, tests their speed and falls back to a direct connection. Hugging Face repository links list their files for selection, with a configurable mirror (default hf-mirror.com) and an access token for gated models.
- Browser extension and download takeover The extension is listed on the Chrome Web Store, Microsoft Edge Add-ons and Firefox Add-ons; the app can also install it in one click in Chromium browsers or export a CRX file. After token-based pairing over a local WebSocket (default port 14370), it intercepts browser downloads and passes cookies and headers to the desktop app. Skip lists for extensions, domains and small files, and an Alt-click bypass, are configurable.
- Media sniffing and Cat Catch tools A download button appears over playing videos, and the popup lists every media request on the page, including separate video and audio tracks that can be merged. Advanced switches from Cat Catch add a recorder, WebRTC capture, screen capture, deep search, cache capture and a mobile user agent. The popup also offers batch image downloads and a media control panel.
- Edit tasks while they run Unfinished tasks can change URL, file name, directory, number of connections, proxy, browser profile and request headers, including pasting a cURL command. Progress is kept if the new URL serves the same content. Request header presets can be applied to new tasks.
- Browser TLS profiles and proxies The README lists real-browser TLS fingerprints as a feature: download requests can use a Chrome, Edge, Firefox or Safari profile, match the source browser automatically, or turn emulation off. A global proxy accepts HTTP, HTTPS, SOCKS4 and SOCKS5 URLs with credentials, and identity presets can assign a profile and proxy per domain, as described on the TLS fingerprint page.
- aria2-compatible RPC An optional local service on 127.0.0.1 (default port 16800, token required) accepts
aria2.addUriwith out, dir, header, user-agent and referer options, plusaria2.getVersion, so tools such as LinkSwift can push tasks. Pausing, deleting and status queries over RPC are not implemented, as the RPC page notes. - Command-line tool The
ghdcommand, installed from Settings, can probe a URL, add and start tasks (with file selection for torrents and an output directory), list and inspect tasks, pause, resume, remove and wait for completion. - Queue, categories and scheduling Up to 10 tasks can run concurrently (default 3), and an optional global speed limit is off by default. Batch add expands numeric, letter and list placeholders into many URLs. Categories sort files into folders by extension, and a post-completion action can shut down, restart, hibernate or open a file.
- Settings, data and updates Settings, the task list (JSONL) and rotating logs are stored in a per-user data directory or, in portable mode, next to the executable. SSL certificate verification is off by default and can be enabled under General Download Settings. On startup the app checks GitHub Releases for a new version, which can be disabled in Settings, and downloads updates as normal tasks.
Where Ghost Downloader fits
Taking over downloads from the browser
After installing the extension from a browser store or from Settings and pairing it with the desktop app, clicks on download links are passed to Ghost Downloader together with the page cookies and headers. With draft mode on, a confirmation dialog shows name, size, folder and thread count before the task starts. Requests made while the desktop app is closed are queued and sent when it starts, as the download takeover page explains.
Saving videos from YouTube, Bilibili and other pages
On a video page the hover button or a pasted link opens the add-task dialog, where quality, subtitles, playlist entries, multi-part episodes and a clip range can be chosen. For other sites the extension lists HLS, DASH or split audio and video streams for merged download. The video download page covers the options; DRM-protected streams are out of scope, and users are responsible for complying with site terms and copyright.
Recording live streams
Pasting a live .m3u8 or .mpd URL starts a recording with an optional resolution and duration limit. It ends on stop, at the limit or when the broadcast ends, and is then merged into a .ts file. On the desktop, N_m3u8DL-RE and FFmpeg are installed from Settings first; the Android app has them built in and keeps recording in the background.
Large files, torrents and model repositories
ISO images and installers use segmented HTTP or FTP downloads that resume after a pause or restart. Torrents and magnet links allow per-file selection and seeding limits. GitHub release assets can go through the built-in mirror accelerator, and Hugging Face links list repository files for selection, with a mirror and access token set under Settings.
Feeding tasks from other tools
Tools that speak aria2 RPC can send URLs to the local endpoint at http://127.0.0.1:16800/jsonrpc with the token shown in Settings, without installing aria2. Scripts can use the ghd command to add tasks, wait for them and remove them. Clipboard monitoring, drag and drop and the batch URL syntax cover manual bulk input.
Extending protocol and site support
Every protocol and site handler is a Feature Pack with a parser chain ordered by priority. The built-in packs table and the Feature Pack tutorial in the developer documentation show how a new handler is added; the README roadmap lists the plugin API as still stabilising before it is made public.
Reviews of Ghost Downloader
Be the first to share your experience with Ghost Downloader.
Write a review
Loading review form…
Found Ghost Downloader useful? Upvote it todayYour vote helps other IT teams find it in the daily ranking.






