Lidhra

A fast, native, cross-platform download & transfer app.
One Rust core, the interface each OS actually deserves. Link what matters.

---

Status: early / work-in-progress. The core libraries are built, tested, and usable from the CLI. The desktop/mobile/TV GUI shells are designed (see design/) but not yet implemented. This is a real, evolving codebase - not a finished product.

Lidhra is a reimagining of the classic torrent client as a modern download manager that:

• speaks each platform's native design language (Liquid Glass, Material 3, Fluent, libadwaita) from one shared Rust core;
• integrates every major debrid service (Real-Debrid, AllDebrid, TorBox, Premiumize, …) so the cloud does the torrenting and your device only ever does an encrypted HTTPS download - which also means it can ship on the App Store;
• stays tiny (Tauri + system webview, no bundled Chromium) and private (no accounts, no telemetry).

Why debrid?

The device hands a magnet to a debrid cloud service the user already pays for; that service torrents it on its servers and returns a direct TLS-encrypted HTTPS link. Lidhra is then just a resumable download manager - no P2P on the device. A full local BitTorrent engine remains available in the directly-distributed build.

Repository layout

crates/          Rust workspace - the engine (builds & tested in CI)
  lidhra-debrid    unified interface over debrid providers + adapters + registry
  lidhra-transfer  segmented, resumable HTTPS download engine
  lidhra-cli       the `lidhra` binary: magnet -> debrid -> download
  lidhra-server    local HTTP server + JSON API (the headless / Web-UI mode)
ui/              the shared web UI - one page that runs in a browser (server) or a
                 native window (Tauri); auto-detects which and talks to the right backend
app/             the Tauri desktop app - native shell wrapping ui/ (compiles on macOS)
design/          the complete design system - brand, tokens, per-platform mockups,
                 the living styleguide (open design/index.html), developer color files
docs/            the marketing website (deployed to lidhra.peterdsp.dev via GitHub Pages)

The crates

Crate	What it does	State
lidhra-debrid	DebridProvider trait + adapters for Real-Debrid (live-tested), AllDebrid, TorBox, Premiumize, a provider registry (build_provider), and a cross-provider policy/failover engine.	builds + unit-tested
lidhra-transfer	Segmented, resumable HTTPS downloads: parallel Range connections, .part files with atomic rename, resume-from-partial.	verified byte-identical on live downloads
lidhra-cli	lidhra add "<magnet>" --provider <name> - runs the whole pipeline end to end.	runs
lidhra-server	Serves the web UI + a JSON API over the engine - "Lidhra like qbittorrent-nox."	runs (verified)
app/ (Tauri)	Native desktop shell wrapping the same UI; commands call the crates directly.	compiles on macOS

Quick start

# build & test everything
cd crates
cargo test --workspace

# run the CLI (needs a debrid account)
export DEBRID_TOKEN=your_api_token          # Real-Debrid / AllDebrid / TorBox / Premiumize
cargo run -p lidhra-cli -- add "magnet:?xt=urn:btih:...&dn=ubuntu-24.04.iso" \
    --provider realdebrid --out ~/Downloads

Use a legitimate magnet (a Linux ISO, a Creative-Commons film, your own file).

Run the app - a real UI you can click:

cargo run -p lidhra-server         # then open http://127.0.0.1:8787
# - or the native desktop window -
cargo install tauri-cli --version "^2" && cargo tauri dev

Platform reach (honest)

Lidhra targets ~every screen, in three tiers:

• Native app - macOS, Windows, Linux, iOS/iPadOS, Android, Linux mobile, Apple TV, Android/Google TV (covers Sony, newer Panasonic, TCL, Hisense…), Fire TV.
• Same web UI, re-packaged - Samsung Tizen, LG webOS, HarmonyOS (web/ArkUI), and a PWA everywhere.
• Cast-only (no third-party app path) - Vizio SmartCast, Roku, older Panasonic → reached by casting a stream to them.

On a TV, Lidhra is a library + player (stream your cloud), not a downloader.

Roadmap

• lidhra-debrid - trait, adapters (RD / AllDebrid / TorBox / Premiumize), registry, policy
• lidhra-transfer - segmented + resumable HTTPS engine
• lidhra-cli - end-to-end pipeline
• lidhra-server + ui/ - runnable app (web UI + JSON API over the engine)
• app/ - Tauri desktop shell (compiles; wraps the shared UI)
• Desktop polish - tray / menu-bar surfaces, live download progress events
• tv-mode web UI (D-pad focus) → Tizen / webOS / HarmonyOS / browser TVs
• Native TV shells (Apple TV / Android TV) + lidhra-cast
• More provider adapters: Debrid-Link, Offcloud, Mega-Debrid, Deepbrid, High-Way

License

MIT © Petros Dhespollari. See LICENSE.

Disclaimer

Independent project - not affiliated with the qBittorrent project. Lidhra is a content-neutral, general-purpose download tool.