FluxDown README

The project's README from github.com/zerx-lab/FluxDown. As one markdown file: README.md.

FluxDown Logo

FluxDown

Downloads, Supercharged.

A blazing fast, multi-protocol download manager — the free & open-source IDM alternative.

Latest Release Downloads License: AGPL-3.0 Platform Rust Flutter MCP Server

Awesome Rust Awesome Windows Awesome Free Apps Android FOSS Open Source Android Portainer Unraid CA Chinese Indie Dev

Website · Download · Changelog · FAQ · Feedback

English | 简体中文

Highlights

Features

Feature Description
Rust-Powered Engine Built on Rust and Tokio with zero-cost abstractions — memory-safe concurrency at maximum throughput
Smart Segmentation Segments split dynamically at runtime; idle threads rescue slow segments, just like IDM — but smarter
Multi-Protocol Dedicated engines for HTTP/HTTPS, FTP, BitTorrent (DHT/UPnP/magnet), eD2K (server + Kad DHT source finding, MD4 verification), HLS (AES-decrypt) and DASH
Speed Control Token-bucket global rate limiting — download in the background without killing your browsing
Resume Anywhere Every byte tracked in SQLite with WAL; power loss never costs you progress
Browser Integration Three-layer download interception, streaming media sniffing, Alt+Click bypass, right-click send
MCP Server Built-in Model Context Protocol endpoint (Streamable HTTP) with 12 tools — AI agents can add, monitor and control downloads
Beautiful Interface shadcn-style widgets, IDM-style segment visualization, named queues, system tray
Clean & Private Zero ads, zero telemetry lock-in, zero accounts — your data never leaves your machine

FluxDown vs. IDM

FluxDown IDM
Price Free & open source $24.95 + renewals
Open source Yes (AGPL-3.0) No
Platforms Windows / macOS / Linux / NAS / Android Windows only
BitTorrent & magnet Yes No
eD2K / eMule links Yes No
HLS / DASH streaming Yes Partial
Dynamic segmentation Yes Yes
Browser extension Chrome / Edge / Firefox Yes
Ads & tracking None —

Installation

Grab the latest build from GitHub Releases or fluxdown.zerx.dev:

Platform Packages
Windows (x64 / ARM64) setup.exe installer · portable .zip
macOS (Intel / Apple Silicon) .dmg · portable .tar.gz
Linux (x64) .AppImage · .deb · Arch .pkg.tar.zst · portable .tar.gz
Android (arm64-v8a / armeabi-v7a / x86_64) per-ABI .apk · universal .apk
NAS / Server (headless, x64 / ARM64) Docker · Synology DSM 6/7 .spk · QNAP .qpkg · OpenWrt .ipk · Unraid CA template · CasaOS / ZimaOS app store

Browser Extension

Install the extension so FluxDown takes over browser downloads automatically:

Chrome Web Store Edge Add-ons Firefox Add-ons

MCP Server (Model Context Protocol)

FluxDown ships a built-in MCP server so AI agents (Claude Desktop, Cursor, Cline, …) can manage downloads via the Model Context Protocol. It speaks Streamable HTTP (JSON-RPC 2.0 over a single POST /mcp) on the local API port — no extra process needed.

Tools (12)

Tool Description
download_add Create a download task (HTTP/HTTPS, FTP, magnet, BitTorrent)
download_list List tasks with progress/speed/status, optional status filter
download_get Get a single task by ID
download_pause / download_resume Pause / resume one task
download_pause_all / download_resume_all Pause / resume all tasks
download_remove Remove a task, optionally deleting downloaded files
queue_list List named queues and their configuration
rss_list List RSS subscriptions with their configuration and runtime state
rss_add Subscribe to an RSS feed and start polling it on a schedule
rss_remove Delete an RSS subscription and the items it collected

Client configuration

{
  "mcpServers": {
    "fluxdown": {
      "url": "http://127.0.0.1:17800/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

The MCP layer is implemented in native/api/src/mcp.rs on top of the same ApiHost trait that powers the REST management API and aria2-compatible JSON-RPC.

Architecture

Flutter renders the UI; a zero-FFI Rust engine does the heavy lifting. The two talk through Rinf signals, and the browser extension connects via Native Messaging.

flowchart TD
    EXT["Browser Extension (WXT)"] -->|Native Messaging| NMH["fluxdown_nmh"]
    NMH -->|Named Pipe / Unix socket| HUB
    UI["Flutter UI (shadcn_ui)"] <-->|Rinf signals| HUB["hub — FFI adapter"]
    HUB --> ENGINE["fluxdown_engine"]
    ENGINE --> HTTP["HTTP/HTTPS"]
    ENGINE --> FTP["FTP"]
    ENGINE --> BT["BitTorrent"]
    ENGINE --> ED2K["eD2K"]
    ENGINE --> HLS["HLS / DASH"]
    ENGINE --> DB[("SQLite")]
Layer Tech Path
UI Flutter + shadcn_ui lib/
FFI bridge Rinf (Dart ↔ Rust signals) native/hub/
Download engine Rust + Tokio (zero FFI deps) native/engine/
Browser extension WXT + TypeScript fluxDown/
Website Astro + React website/

Building from Source

Prerequisites: Flutter SDK · Rust toolchain · Rinf CLI

# Clone the development branch (main = active development, stable = stable releases)
git clone -b main https://github.com/zerx-lab/FluxDown.git
cd FluxDown

# Check your environment
rustc --version
flutter doctor

# Install the Rinf CLI (once)
cargo install rinf_cli

# Fetch dependencies & generate Dart bindings
flutter pub get
rinf gen

# Run in debug mode
flutter run

# Build a release
flutter build apk --release       # or: ios
Running tests 
flutter test                          # Dart tests
cargo test -p fluxdown_engine        # Rust engine tests
cargo test -p hub                    # FFI adapter tests

Contributing & Community

Pull requests are welcome! Branch off main and target main — it is the development branch, while stable only tracks stable releases (maintainers advance it from main). Before submitting, please make sure:

cargo fmt --check && cargo clippy -- -D warnings   # Rust
flutter analyze                                     # Dart

See CONTRIBUTING.md for the full workflow.

License

Distributed under the GNU Affero General Public License v3.0.

If FluxDown saves you time, consider giving it a Star — it helps more people discover the project.

Made by zerx-lab

FluxDown (zerx-lab/FluxDown)

Searching Database…

4.6K ·GitHub
FluxDown
Что это?FluxDown — бесплатный менеджер загрузок с открытым кодом на Rust, который поддерживает HTTP/HTTPS, FTP, BitTorrent, eD2K и потоковые загрузки HLS/DASH; позиционируется как бесплатная альтернатива IDM.
Это десктоп-приложение, браузерное расширение или и то и другое?Это приложение для десктопа/NAS с движком на Rust и интерфейсом на Flutter, плюс сопутствующее браузерное расширение (Chrome/Edge/Firefox), которое перехватывает загрузки из браузера и передаёт их в приложение.
Браузерное расширение обязательно для работы?Нет, расширение необязательно — оно лишь позволяет FluxDown автоматически перехватывать загрузки браузера вместо того, чтобы добавлять ссылки вручную.
На каких платформах он работает?Windows (x64/ARM64), macOS (Intel/Apple Silicon), Linux (x64), Android, а также NAS/серверы (Docker, Synology, QNAP, OpenWrt, Unraid, CasaOS).
Отправляет ли он какие-то данные с моего компьютера?Нет — FluxDown работает локально: без рекламы, телеметрии и обязательных аккаунтов; все данные, включая состояние загрузок, остаются на устройстве.
Чем FluxDown быстрее обычного загрузчика?Он использует движок Rust + Tokio с динамической сегментацией в стиле IDM: свободные потоки на лету подхватывают медленные сегменты, что даёт до 10-кратного ускорения.
Могут ли ИИ-агенты вроде Claude или Cursor управлять моими загрузками?Да, во FluxDown встроен MCP-сервер (Model Context Protocol) с 12 инструментами: добавление, список, пауза, возобновление и удаление загрузок, управление RSS-подписками; доступ — по локальному Streamable HTTP с авторизацией bearer-токеном.
Он поддерживает торренты и magnet-ссылки?Да, есть отдельный BitTorrent-движок с поддержкой DHT, UPnP и magnet-ссылок, а также поддержка eD2K/eMule (поиск источников через серверы и Kad DHT с проверкой MD4).
Он может скачивать стримовое видео (HLS/DASH)?Да, есть отдельные движки для HLS с расшифровкой AES и для DASH-стримов — то, что IDM поддерживает лишь частично.
What are similar projects?Motrix, edgeever, Ketch, rayburst, hister, hydra, Surge, joplin
Which topics is it in?self-hosted-ai, download, firefox-extension, flutter, downloader, offline-first, raspberry-pi, chrome-extension, browser-extension, agpl, streaming, sqlite
Creator
zerx-lab
Size
80.2 MB
Stars
4.6K
Updated
CommitOct 17Releasev0.5.7Oct 15
Age
3mo
Commits · 90 Days