kuasarr 2.0.2

kuasarr connects JDownloader with Radarr, Sonarr and LazyLibrarian. It also decrypts links protected by CAPTCHAs, using an additional CaptchaSolverr.

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.

---

---

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. No config file editing required – everything is done through the interface.

Optional: Environment Variables

Variable	Description
TZ	Timezone (e.g. Europe/Berlin)
INTERNAL_ADDRESS	Local URL (for internal API calls)
EXTERNAL_ADDRESS	External URL (for downloads)

---

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