kuasarr

Kuasarr

Bridge JDownloader with Radarr, Sonarr & LazyLibrarian

Kuasarr emulates a Newznab Indexer and SABnzbd Client to integrate JDownloader into your *arr stack. No NZBs, no torrents – pure direct download.

Dashboard

Quick Start

docker run -d \
  --name kuasarr \
  -p 9999:9999 \
  -v /path/to/config:/config \
  ghcr.io/ritedt/kuasarr:latest

Open http://localhost:9999 and follow the setup wizard in the WebUI. On first start you're prompted for the internal/external URL directly in the browser — no config file editing required, everything is done through the interface.

Tip: For deterministic deployments (e.g. compose/automated setups), pass -e INTERNAL_ADDRESS=http://<host-ip>:9999 to skip the first-start prompt. TZ, EXTERNAL_ADDRESS and the credentials below work the same way.

Optional: Environment Variables

Environment variables always override WebUI settings (useful for Docker secrets). Anything not set here is configurable through the WebUI.

Variable	Description
`TZ`	Timezone (e.g. `Europe/Berlin`)
`INTERNAL_ADDRESS`	Local URL Radarr/Sonarr use to reach Kuasarr
`EXTERNAL_ADDRESS`	External URL (defaults to internal)
`KUASARR_WEBUI_USER` / `KUASARR_WEBUI_PASS`	Optional WebUI login (ENV or WebUI → Settings → General)
`DBC_MAX_CONCURRENT`	Max concurrent CAPTCHA jobs (default `1`; requires restart)

What is Kuasarr?

Kuasarr automates the entire DDL workflow – from search to download. No manual CAPTCHA solving required.

Feature	Description
🎨 Modern UI	Intuitive dark-theme web interface – complete configuration without CLI
🔍 Indexer	Searches DDL sites for releases
🤖 Auto-CAPTCHA	Automatic solving via DeathByCaptcha or 2Captcha – no manual interaction needed
📥 Download	Sends links directly to JDownloader
🎯 Tracking	Radarr/Sonarr automatically detect completed downloads

Required External Services

Service	Cost	Purpose
FlareSolverr	Free	Bypasses Cloudflare protection
DeathByCaptcha or 2Captcha	Paid	Solves CAPTCHAs automatically
JDownloader 2	Free	Downloads the actual files

Important: DeathByCaptcha and 2Captcha are paid services (approx. $2-4 per 1000 CAPTCHAs). You need an active account with one of them for Kuasarr to work.

Setup Guides

Configuration of external tools is outsourced to dedicated guides:

Tool	Guide
FlareSolverr	Setup →
JDownloader 2	Setup →
Radarr	Setup →
Sonarr	Setup →
LazyLibrarian	Setup →

Advanced Configuration

CAPTCHA Services

Configurable via WebUI or environment variables:

Variable	Service
`DBC_AUTHTOKEN`	DeathByCaptcha
`TWOCAPTCHA_API_KEY`	2Captcha

WebUI Authentication (optional)

docker run -d \
  --name kuasarr \
  -p 9999:9999 \
  -v /path/to/config:/config \
  -e KUASARR_WEBUI_USER=admin \
  -e KUASARR_WEBUI_PASS=securepassword \
  ghcr.io/ritedt/kuasarr:latest

API endpoints (/api/*, /download/*) are secured via API key for *arr integration – no additional authentication required.

Install as PWA

Kuasarr can be installed as a Progressive Web App:

Chrome/Edge: Address bar → Install icon
Android: Chrome menu → "Add to Home screen"
iOS: Safari → Share → "Add to Home Screen"

Requires HTTPS for full functionality.

Supported Sources

NX (with login)
SJ / DJ (with login)
Filecrypt (with Circle-Captcha solver)
More via custom hostnames

Architecture

┌─────────┐     ┌─────────┐     ┌─────────┐
│ Radarr  │────→│         │────→│JDownloader
│ Sonarr  │     │ Kuasarr │     │   2     │
│ LazyLib │────→│  :9999  │────→└─────────┘
└─────────┘     └────┬────┘          │
                     │               ↓
                ┌────┴────┐     ┌─────────┐
                │Hostnames│     │  Downloads
                │FlareSolv│     └─────────┘
                └─────────┘

Support

Matrix: @kuasarr-support:envs.net
Issues: GitHub Issues

License

MIT License – Fork of rix1337/quasarr

Metadata

Release files for kuasarr 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for kuasarr 2.1.0
File	Interpreter	ABI	Platform	Reset
kuasarr-2.1.0-py3-none-any.whl 1.3 MB Oct 16, 2026	Python 3	none	any	Details

Release files / kuasarr-2.1.0-py3-none-any.whl

Download URL	kuasarr-2.1.0-py3-none-any.whl
Size	1.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`c69a831da087d8bdaf05b0d3751301692cd80ae035423c2b7065c6aa6a37a1c9`
BLAKE2b-256 checksum How to use checksums	`d740d62432fb4d26c190fbd7b4b668f535bf3f4b9cdebe27e39dfb88c123dbe2`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`