High-Performance BitTorrent & Media Downloader — purpose-built for the Servarr (*arr) ecosystem

---

What is Leecharr?

Leecharr is a modern, high-performance BitTorrent and media downloader purpose-built for the Servarr (*arr) ecosystem (Sonarr, Radarr, Lidarr, Prowlarr, Readarr).

Unlike conventional standalone clients (Deluge, qBittorrent, Transmission) that present torrents as raw filenames and technical progress bars, Leecharr deeply enriches active downloads with metadata and artwork directly from Sonarr, Radarr, and Lidarr — giving you movie posters, TV show banners, episode screenshots, artist fanart, media stream specs, and cast overviews in a unified, beautiful Servarr interface.

---

Key Features

🌟 Deep *arr Media Enrichment

• Automatic Media Correlation: Matches torrents by release title, info hash, or *arr download ID to pull rich media metadata.
• Visual Media Experience: Displays high-res posters, fanart backdrops, season banners, and episode titles.
• Season Pack Hierarchy: Automatically groups multi-file TV season packs by Show → Season → Episode.
• Media Stream Info: Shows resolution (4K, 1080p), HDR format (Dolby Vision, HDR10+), audio codecs (Dolby Atmos, TrueHD, FLAC), and subtitle tracks.

⚡ Pure C# .NET 10 BitTorrent Engine

• Rarest-First & Endgame Mode: Optimal swarm health and piece distribution.
• Sequential Download Mode: Enables instant video streaming and file previewing while actively downloading.
• Per-File Priority Management: Skip unwanted files or prioritize specific files.
• Non-Blocking Async Disk I/O: Write/read caching (64MB–512MB) and sparse pre-allocation to prevent disk bottlenecking.
• Fast Resume Persistence: Checkpoints piece bitfields and states to SQLite for instant startup without full re-hashing.
• MSE/PE Stream Encryption: Diffie-Hellman 768-bit key exchange + RC4 stream cipher.
• BEP Protocol Support: HTTP & UDP Trackers (BEP 3, BEP 15, BEP 12 Multi-Tracker), DHT (BEP 5), PEX (BEP 11), ut_metadata (BEP 9), Fast Extension (BEP 6), LPD (BEP 14), and uTP (BEP 29).

🔌 Download Client Compatibility

• Deluge JSON-RPC Adapter: Connects seamlessly to tools expecting Deluge daemon.
• qBittorrent WebAPI v2 Adapter: Acts as a drop-in qBittorrent client for existing apps.
• Transmission RPC Adapter: Compatible with Transmission remote clients.
• Native Leecharr REST API v1 & SignalR: Sub-second push for speed pulses, piece maps, and swarm events.

---

⚡ Quick Start

Leecharr container images are available on both Docker Hub and GitHub Container Registry (GHCR).

Run with Podman / Docker

Option 1: Docker Hub

podman run -d \
  --name leecharr \
  -p 7889:7889 \
  -p 7890:7890/tcp \
  -p 7890:7890/udp \
  -v leecharr-config:/config \
  -v leecharr-downloads:/downloads \
  --restart unless-stopped \
  feeditout/leecharr:latest

Option 2: GitHub Container Registry (GHCR)

podman run -d \
  --name leecharr \
  -p 7889:7889 \
  -p 7890:7890/tcp \
  -p 7890:7890/udp \
  -v leecharr-config:/config \
  -v leecharr-downloads:/downloads \
  --restart unless-stopped \
  ghcr.io/dmzoneill/leecharr:latest

Container Compose (compose.yaml / podman-compose.yml)

services:
  leecharr:
    # Option 1: Docker Hub
    image: feeditout/leecharr:latest
    # Option 2: GitHub Container Registry (GHCR)
    # image: ghcr.io/dmzoneill/leecharr:latest
    container_name: leecharr
    restart: unless-stopped
    ports:
      - "7889:7889"
      - "7890:7890/tcp"
      - "7890:7890/udp"
    volumes:
      - /opt/leecharr/config:/config
      - /opt/leecharr/downloads:/downloads
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC

---

Documentation & Changelog

• Changelog & Version History
• Architecture Guide
• Domain Model
• Media Enrichment Specification
• BitTorrent Protocols
• REST API Reference
• Development & Setup Guide

---

License

Distributed under the Apache License 2.0. See LICENSE for details.

---

_{Built with the Sonarr/Radarr architecture pattern
Part of the *arr family of applications
www.leecharr.net}