A high-performance, multi-threaded download manager built with Electrobun, React, and native Bun Workers.
FluxDL leverages Bun's native multi-threading capabilities to segment file payloads natively across the operating system. By bypassing traditional Node overhead and utilizing raw OS streams, it provides maximum throughput and reliability for heavy downloads.
- Segmented Downloads: Native Bun Workers fetch concurrent HTTP byte ranges for accelerated speeds.
- RPC Bridge: Type-safe frontend-to-backend communication via Electrobun.
- SQLite Persistence: Native Write-Ahead Logging (WAL) for durable, fast metadata and settings storage.
- Optimized UI: React frontend utilizing
React.memoand AbortControllers to prevent render thrashing even during high-speed transfers. - Dynamic Configuration: Hot-swappable concurrency limits and category-based download directories.
You must have Bun installed on your system.
- Clone the repository:
git clone https://github.com/faw7an/fluxdl.git
- Install dependencies:
bun install
- Launch development mode (Vite HMR + Electrobun):
bun run dev:hmr
To generate a production-ready Linux release build:
bun run build:linuxArtifacts will be packaged inside the build/ directory.
- Project Architecture - Deep dive into the RPC bridge and engine.
- Development Guide - Workflow, debugging, and build scripts.
- AI Agents Guide - Structural boundaries and coding standards for this repo.
Built with precision over the Bun runtime.