# Firelink > A fast, focused desktop download manager for macOS, Windows, and Linux. [![Latest release](https://img.shields.io/github/v/release/nimbold/Firelink?style=flat-square)](https://github.com/nimbold/Firelink/releases/latest) [![CI](https://img.shields.io/github/actions/workflow/status/nimbold/Firelink/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/nimbold/Firelink/actions/workflows/ci.yml) [![License](https://img.shields.io/github/license/nimbold/Firelink?style=flat-square)](LICENSE) [![macOS](https://img.shields.io/badge/macOS-Apple%20silicon-111111?style=flat-square&logo=apple&logoColor=white)](#installation) [![Windows](.github/badges/windows.svg)](#installation) [![Linux](https://img.shields.io/badge/Linux-x64-FCC624?style=flat-square&logo=linux&logoColor=black)](#installation)

Firelink dark theme main window Firelink dark theme add window Firelink light theme main window Firelink light theme add window

## What is Firelink? Firelink manages direct downloads, browser captures, media, playlists, queues, and scheduling from one desktop app. It uses a Rust and Tauri backend with a React and TypeScript interface. Required download and media engines are bundled with the app. ## Status Firelink `1.2.0` is the latest desktop release. It is paired with [Firelink Companion `2.0.6`](https://github.com/nimbold/Firelink-Extension/releases/tag/v2.0.6). The project is actively maintained. See the [changelog](CHANGELOG.md) for release history and current work. Translations are available for English, Simplified Chinese, Hebrew, Persian, Ukrainian, and Russian. Translation corrections are welcome. ## Features - Segmented HTTP and HTTPS downloads with retries, speed limits, and connection controls. - Media and playlist downloads through yt-dlp, FFmpeg, and Deno. - An Add window for metadata, duplicate handling, save locations, and download options. - Persistent queues with pause, resume, retry, redownload, and scheduling. - A customizable download table with sorting, column selection, reordering, and bulk actions. - File organization with categories, default folders, and per-download locations. - Browser handoff through local pairing and signed requests. - Tray controls, notifications, sounds, sleep prevention, and secure credential storage. - RTL support for Hebrew and Persian. ## Installation Download the [latest Firelink release](https://github.com/nimbold/Firelink/releases/latest). | Platform | Package | Notes | | --- | --- | --- | | macOS Apple silicon | `.dmg` | Ad-hoc signed and not notarized. macOS may require approval in **System Settings -> Privacy & Security**. | | Windows x64 | NSIS `.exe` | Unsigned. Windows SmartScreen may display a warning. | | Windows x64 portable | `.zip` | Extract to a writable folder and launch `firelink.exe`. | | Linux x64 | `.deb`, `.rpm`, or `.AppImage` | Choose the package for your distribution, or use AppImage. | All packages include aria2, yt-dlp, FFmpeg, Deno, and SQLite support. No separate engine installation is required.

Windows portable ZIP notes

- Keep the folder writable. Avoid `Program Files` and read-only media. - Settings, queues, logs, and WebView data are stored beside the executable in `data/`. - Close Firelink before moving or copying the folder. - Treat the folder as sensitive because it contains the extension pairing credential. - The installer remains the supported path for `firelink://` browser launch registration.

## Browser integration [Firelink Companion](https://github.com/nimbold/Firelink-Extension) connects browser downloads, links, and media pages to Firelink. Captured links open Firelink's Add window for review before they are started or queued.

See the [Companion README](https://github.com/nimbold/Firelink-Extension#readme) for browser installation, pairing, and privacy details. ## Development ### Requirements - Node.js 22 or newer - npm - Rust and Cargo - [Tauri 2 platform prerequisites](https://v2.tauri.app/start/prerequisites/) ### Quick start ```sh git clone --recurse-submodules https://github.com/nimbold/Firelink.git cd Firelink npm install npm run tauri dev ``` Run the main checks with: ```sh node --test scripts/*.node-test.js npm test -- --run npm run build cd src-tauri && cargo test --all-targets ``` See [RELEASE.md](RELEASE.md) for engine provisioning, packaging, and release verification. ## Contributing and support - Report bugs and request features in [GitHub Issues](https://github.com/nimbold/Firelink/issues). - Open focused pull requests with tests for behavior changes. - Report translation corrections in an issue or pull request. - Read [CHANGELOG.md](CHANGELOG.md) for release history. ## Credits Core technologies: - [Tauri 2](https://v2.tauri.app/), [Rust](https://www.rust-lang.org/), [Tokio](https://tokio.rs/) - [React](https://react.dev/), [TypeScript](https://www.typescriptlang.org/), [Zustand](https://zustand-demo.pmnd.rs/) - [SQLite](https://www.sqlite.org/) Bundled engines: - [aria2](https://aria2.github.io/) - [yt-dlp](https://github.com/yt-dlp/yt-dlp) - [FFmpeg](https://ffmpeg.org/) - [Deno](https://deno.com/) Font licenses, engine versions, source references, and third-party notices are documented in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). ## License Firelink is available under the [MIT License](LICENSE). Bundled tools and fonts retain their own licenses.