Leecharr

BitTorrent Media Downloader — the *arr-family rich media client.

Rich Media Enrichment Sequential Streaming Sonarr, Radarr & Lidarr Deluge & qBittorrent RPC Docker Ready
Download View on GitHub
.NET 10
Runtime
React 19
Frontend
7889
Default Port
10+
BEP Protocols
3
RPC Adapters
...
Latest Version

See it in Action

Click any screenshot to view full size

Features

Everything you need to download and manage BitTorrent media — enriched with artwork, sequential streaming, and deep Servarr automation.

localhost:7889 — Leecharr
Dune.Part.Two.2024.2160p.UHD Streaming ↓ 38.4 MB/s
Shogun.2024.S01E08.1080p Downloading ↓ 16.2 MB/s
Oppenheimer.2023.IMAX.2160p Seeding ↑ 5.8 MB/s
The.Bear.S03.Complete.1080p Queued ― 0 B/s

Deep *arr Media Enrichment

Experience your downloads visually. Leecharr pairs BitTorrent transfers with rich artwork, movie posters, season banners, audio specs, and episode information directly from your Servarr apps.

  • Movie posters, fanart backdrops, and TV season banners
  • Season pack hierarchy (Show → Season → Episode)
  • Media stream info: 4K, HDR10+, Dolby Vision, Atmos, FLAC
  • Sequential download mode for instant video streaming
  • Sub-second speed graphs & piece maps via SignalR
  • Per-file priority selection and selective downloading
Protocol Stack & Transport
HTTP Tracker
● BEP 3 — Active
UDP Tracker
● BEP 15 — Active
DHT (Mainline)
● BEP 5 — Active
Peer Exchange
● BEP 11 — Active
MSE/PE Encryption
● RC4 + DH — Active
uTP Transport
● BEP 29 — Active
Fast Extension
● BEP 6 — Active
ut_metadata
● BEP 9 — Magnet

High-Performance .NET 10 Engine

Leecharr implements a native, high-throughput BitTorrent engine in pure C# .NET 10. Non-blocking asynchronous disk I/O, memory caching, and full protocol compliance deliver blazing speeds.

  • Rarest-first, endgame, and sequential piece strategies
  • HTTP & UDP tracker scrape/announce with multi-tracker failover (BEP 12)
  • Diffie-Hellman MSE/PE stream cipher encryption
  • DHT distributed hash table & PEX swarm discovery
  • Configurable write/read disk cache (64MB–512MB)
  • Fast resume piece bitfield persistence in SQLite
Client RPC Compatibility
qBittorrent
WebAPI v2
Deluge
JSON-RPC
Transmission
RPC Adapter
Indexer & Automation
Prowlarr Sync Torznab / Newznab Webhooks REST API

Universal Client Compatibility

Drop Leecharr into any existing automation pipeline. Built-in RPC adapters emulate Deluge, qBittorrent, and Transmission, allowing 3rd-party tools and mobile apps to interact with Leecharr without modifications.

  • Drop-in qBittorrent WebAPI v2 adapter
  • Deluge daemon JSON-RPC compatibility
  • Transmission RPC endpoint support
  • Native Leecharr REST API v1 (/api/v1/) with Swagger UI
  • Webhook dispatch for download lifecycle events
  • Direct Torznab/Newznab indexer search & Prowlarr sync

Sequential Streaming

Stream videos and preview music files instantly in your browser while the torrent is actively downloading.

Direct Indexer Search

Search Torznab and Newznab indexers directly within Leecharr with automatic Prowlarr synchronization.

Rich Webhooks & Alerts

Webhook, Discord, and email triggers with full media artwork and metadata on grab and download completion.

REST API & Swagger

Comprehensive OpenAPI specification at /api/v1/ with interactive Swagger UI at /swagger.

Speed Scheduling

Define upload and download speed profiles by time of day and day of week to manage home network bandwidth.

SQLite + PostgreSQL

Embedded SQLite by default with fast piece checkpoints; PostgreSQL supported for multi-instance deployments.

*arr Integration

Connect seamlessly to your Servarr stack. Leecharr automatically enriches active downloads with posters, metadata, and category mappings from your arr apps.

Sonarr

TV series posters, episodes & season packs

Radarr

Movie artwork, trailers & video stream specs

Lidarr

Artist fanart, album covers & audio tags

Prowlarr

Direct indexer sync & proxy routing

Readarr

Book covers, authors & publication details

Setup in 3 steps

  1. Go to Settings > Arr Connections in Leecharr
  2. Add your Sonarr, Radarr, Lidarr, or Prowlarr URL and API key
  3. Leecharr imports active downloads and pulls full media artwork and metadata

Download

Leecharr runs on any platform that supports .NET 10. Docker is the recommended deployment.

Docker (Recommended)

The easiest way to run Leecharr. The official image is published to Docker Hub and GHCR.

docker run -d \
  --name leecharr \
  -p 7889:7889 \
  -p 51413:51413 \
  -v leecharr-config:/config \
  -v leecharr-downloads:/downloads \
  --restart unless-stopped \
  feeditout/leecharr:latest

Then open http://localhost:7889

Docker Compose / Podman Compose

services:
  leecharr:
    image: feeditout/leecharr:latest
    container_name: leecharr
    ports:
      - "7889:7889"
      - "51413:51413"
    volumes:
      - leecharr-config:/config
      - leecharr-downloads:/downloads
    restart: unless-stopped
    environment:
      - TZ=UTC
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:7889/api/v1/system/status"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 30s

volumes:
  leecharr-config:
  leecharr-downloads:
docker compose up -d
# or
podman-compose up -d

GHCR alternative: ghcr.io/dmzoneill/leecharr:latest

Volumes: /config stores the database, settings, and logs. /downloads holds downloaded media files and torrent data.

Linux

Leecharr requires .NET 10 runtime. Use the generic tar.gz for manual installation on any Linux distribution.

Linux x64 Linux arm64 Linux arm
  1. Download the appropriate archive for your architecture.
  2. Extract and move to a suitable directory (e.g. /opt/leecharr).
  3. Run ./Leecharr or create a systemd unit file for autostart.
  4. Browse to http://localhost:7889
For production use on Linux, Docker is strongly recommended for isolation and easy updates.

macOS

Leecharr supports macOS on both Intel and Apple Silicon (arm64).

Intel (x64) Apple Silicon (arm64)
  1. Download the macOS archive for your CPU.
  2. Extract and move Leecharr.app to your Applications folder.
  3. Self-sign if needed: codesign --force --deep -s - /Applications/Leecharr.app
  4. Open Leecharr.app and browse to http://localhost:7889

Windows

Leecharr can run as a Windows Service or System Tray Application. Supports Windows 10 / Server 2019 or later.

Windows x64 Installer Windows x86 Installer
  1. Download and execute the installer.
  2. Choose between Windows Service (always running) or System Tray Application (runs when logged in).
  3. Browse to http://localhost:7889
Windows Service accounts do not have access to network drives by default. If your config is on a mapped drive, use the System Tray installation instead.

NAS Devices

Leecharr runs on most NAS devices via Docker. Synology, QNAP, Unraid, and TrueNAS are all supported.

Synology

  1. Install Container Manager from the Package Center.
  2. Pull feeditout/leecharr:latest from Docker Hub.
  3. Configure port 7889 and map volumes for /config and /downloads.
  4. Browse to http://<NAS-IP>:7889

Unraid

  1. Open the Community Applications plugin.
  2. Search for Leecharr.
  3. Click Install and follow the prompts.

TrueNAS SCALE

  1. Use the built-in Docker support or install via TrueCharts catalog.
  2. Set the app data path to a dataset on your pool.

Build from Source

Requirements: .NET 10 SDK, Node.js 24+, npm.

git clone https://github.com/dmzoneill/Leecharr.git
cd Leecharr

# Backend
dotnet run --project src/NzbDrone.Console/Leecharr.Console.csproj

# Frontend (hot reload dev server)
cd src/Leecharr.Frontend
npm install
npm start

Makefile targets

make setup          # Restore .NET + npm dependencies
make build          # Build release
make test           # Run unit tests
make publish        # Publish release artifacts
make frontend       # Build production frontend bundle
The frontend dev server proxies API calls to the backend on port 7889. Both must be running simultaneously during development.