# Quasarr > Setup, configure, debug and extend Quasarr — the bridge that connects JDownloader with Radarr, Sonarr and LazyLibrarian via a fake Newznab indexer and SABnzbd client interface. Also handles CAPTCHA-protected link decryption. Use this skill whenever the user mentions Quasarr, asks about connecting JDownloader with Radarr/Sonarr, needs help with hostname configuration, FlareSolverr, download categories, notifications, SponsorsHelper, or any Quasarr-related topic. - Skill: `aibot88/quasarr` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add aibot88/quasarr` - Raw SKILL.md: https://api.skillmd.com/api/skills/aibot88/quasarr/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: aibot88 (https://skillmd.com/u/aibot88) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/aibot88/quasarr --- # Quasarr Skill **Repo:** https://github.com/rix1337/Quasarr **Zweck:** Quasarr täuscht Radarr/Sonarr/LazyLibrarian vor, ein Newznab-Indexer **und** ein SABnzbd-Client zu sein. In Wirklichkeit scrapt es deutsche Hoster-Seiten und schickt die gefundenen Links via MyJDownloader an JDownloader weiter. --- ## Architektur im Überblick ``` Radarr/Sonarr ←→ Quasarr (Newznab + SABnzbd) ←→ JDownloader (via MyJD API) ↕ Scraper-Quellen (Hoster-Sites) ↕ FlareSolverr (für Cloudflare-Sites) ``` Quasarr **kennt keine echten NZB- oder Torrent-Dateien**. Es ist komplett Hoster-basiert. --- ## Deployment (Docker — empfohlen für Unraid/BigServer) ```yaml services: quasarr: container_name: 'Quasarr' image: 'ghcr.io/rix1337/quasarr:latest' ports: - '8080:8080' volumes: - '/mnt/user/appdata/quasarr/config:/config:rw' environment: - 'DOCKER=true' - 'INTERNAL_ADDRESS=http://192.168.1.144:8080' # LAN-IP:Port → für Radarr/Sonarr - 'EXTERNAL_ADDRESS=https://quasarr.deine-domain.de' # optional, für Web-UI - 'USER=admin' - 'PASS=sicheres-passwort' - 'AUTH=form' # form | header | none - 'TZ=Europe/Berlin' # Optional: SponsorsHelper (nur für GitHub-Sponsoren) sponsorshelper: container_name: 'SponsorsHelper' image: 'ghcr.io/rix1337/sponsors-helper:latest' restart: unless-stopped depends_on: - quasarr volumes: - '/mnt/user/appdata/quasarr/sponsorshelper:/config' environment: - 'QUASARR_URL=http://192.168.1.144:8080' - 'QUASARR_API_KEY=' - 'FLARESOLVERR_URL=http://flaresolverr:8191/v1' - 'APIKEY_2CAPTCHA=<2captcha-key>' - 'TZ=Europe/Berlin' ``` **Wichtig:** `INTERNAL_ADDRESS` ist Pflicht bei Docker. Radarr/Sonarr müssen diese URL erreichen können. ### Pip-Installation (alternativ) ```bash pip install quasarr quasarr ``` --- ## Ersteinrichtung (Reihenfolge) 1. **FlareSolverr** starten (für AL-Seite erforderlich): `http://host:8191/v1` 2. **JDownloader 2** starten & mit my.jdownloader.org verbinden 3. **Quasarr** starten → Web-UI öffnen 4. Im Web-UI: - **Hostnames** setzen (mindestens eine Quelle) - **FlareSolverr-URL** konfigurieren - **JDownloader-Zugangsdaten** eintragen & Gerät auswählen 5. **Radarr/Sonarr** konfigurieren (siehe unten) --- ## Radarr / Sonarr Konfiguration Quasarr als **Newznab-Indexer** hinzufügen: - URL: `http://` - API Key: aus dem Quasarr-Web-UI Quasarr als **SABnzbd-Download-Client** hinzufügen: - URL/Port: aus `INTERNAL_ADDRESS` (Host + Port) - API Key: gleicher API Key **Wichtig für Sonarr:** Alle Serien auf Serientyp **Standard** setzen. Anime/Absolut wird nicht unterstützt. --- ## LazyLibrarian Konfiguration SABnzbd+ Downloader: - URL/Port aus `INTERNAL_ADDRESS` - API Key: gleicher Key - Kategorie: `docs` (verhindert Konflikte mit Radarr/Sonarr) Newznab Provider: - URL + API Key wie oben - Test & Speichern Unter Importing → `Enable OpenLibrary api` aktivieren, `OpenLibrary` als primäre Quelle setzen. --- ## Quellen / Hostnames Quasarr unterstützt diese Quellen-Kürzel: | Kürzel | Login nötig | Besonderheit | |--------|-------------|--------------| | `al` | ✅ Ja | Braucht FlareSolverr (Cloudflare) | | `at` | ❌ Nein | | | `by` | ❌ Nein | | | `dd` | ✅ Ja | | | `dj` | ✅ Ja | Teilt Credentials mit `sj` (JUNKIES-Section) | | `dl` | ✅ Ja | | | `dt` | ❌ Nein | | | `dw` | ❌ Nein | | | `he` | ❌ Nein | | | `hs` | ❌ Nein | | | `mb` | ❌ Nein | | | `nk` | ❌ Nein | | | `nx` | ✅ Ja | | | `rm` | ❌ Nein | | | `sf` | ❌ Nein | | | `sj` | ✅ Ja | Teilt Credentials mit `dj` (JUNKIES-Section) | | `sl` | ❌ Nein | | | `wd` | ❌ Nein | | | `wx` | ❌ Nein | | Hostnames als reinen Domain-Namen eintragen, z.B. `example.com` (kein `https://`). **Hostname-Import via URL:** Im Hostnames-UI kann eine URL eingegeben werden, die eine INI-ähnliche Liste enthält (`kürzel = domain.tld`). Quasarr parsed und validiert diese automatisch. --- ## Konfiguration (intern) Alle Einstellungen werden verschlüsselt gespeichert (AES-128-CBC) in `config.ini` + SQLite-DBs im `/config`-Verzeichnis. Konfig-Sektionen: - `API` → API-Key - `JDownloader` → user, password, device - `Settings` → hostnames_url - `Hostnames` → ein Key pro Quelle - `FlareSolverr` → url - `Notifications` → discord_webhook, telegram_bot_token, telegram_chat_id - `AL`, `DD`, `DL`, `NX`, `JUNKIES` → user + password pro Login-Quelle --- ## Download-Kategorien Standard-Kategorien: `movies`, `shows`, `docs` Bis zu 10 eigene Kategorien hinzufügbar (nur Kleinbuchstaben + Zahlen, max. 20 Zeichen). Jede Download-Kategorie kann bevorzugte **Mirrors** (Hoster) konfigurieren. Radarr/Sonarr wählen die Kategorie beim Download automatisch. LazyLibrarian → Kategorie `docs` verwenden. --- ## Such-Kategorien (Newznab-Standard) Quasarr meldet Radarr/Sonarr folgende Kategorien via `/api?t=caps`: - Filme (2000) - Serien / TV (5000 + Unterkategorien) - Bücher (7000) - Musik (3000) - Anime (5070) - Dokumentationen (5080) Bis zu 10 benutzerdefinierte Such-Kategorien möglich (ID-Schema: `100000 + Basis-ID`). Jede Such-Kategorie kann auf bestimmte Quellen (Kürzel) beschränkt werden. --- ## CAPTCHA-Handling Bestimmte Links sind CAPTCHA-geschützt (meist via Filecrypt, al.vc, hide.sx). - Quasarr zeigt wartende Links im Web-UI unter `/captcha` - **Manuell:** User klickt Link, löst CAPTCHA im Browser - **Automatisch (SponsorsHelper):** Nur für GitHub-Sponsoren; kombiniert FlareSolverr + 2captcha API Notifications werden bei neuem CAPTCHA-Bedarf verschickt (Discord/Telegram konfigurierbar). --- ## Benachrichtigungen Zwei Provider: **Discord** (Webhook-URL) und **Telegram** (Bot-Token + Chat-ID). Konfigurierbare Ereignisse: - `unprotected` – neue ungeschützte Links - `captcha` – CAPTCHA erforderlich - `solved` – CAPTCHA gelöst - `disabled` – SponsorsHelper deaktiviert - `failed` – SponsorsHelper Fehler - `quasarr_update` – neue Quasarr-Version verfügbar Jedes Ereignis kann pro Provider aktiviert/deaktiviert und auf "silent" (ohne Ping) gesetzt werden. --- ## Quasarr Web-UI Routen | Route | Beschreibung | |-------|-------------| | `/` | Dashboard (JD-Status, Hostnames, API-Key) | | `/packages` | Aktive Download-Pakete | | `/statistics` | Statistiken | | `/hostnames` | Hostname-Verwaltung | | `/categories` | Kategorie-Verwaltung | | `/captcha` | CAPTCHA-Warteschlange | | `/regenerate-api-key` | API-Key neu generieren | --- ## Quasarr interne API-Endpunkte Alle Endpunkte erfordern API-Key als Query-Parameter oder Header. ``` # Newznab Indexer (für Radarr/Sonarr) GET /api?t=caps → Indexer-Fähigkeiten GET /api?t=movie&imdbid=tt1234567 → Film-Suche per IMDb-ID GET /api?t=tvsearch&imdbid=tt1234567&season=1&ep=1 → Serien-Suche GET /api?t=book&author=...&title=... → Buch-Suche (LazyLibrarian) GET /api?t=search&q=... → Freitext (LazyLibrarian/Lidarr) # SABnzbd Client (für Radarr/Sonarr) GET /api?mode=auth → Auth-Check GET /api?mode=version → Version GET /api?mode=get_cats → Kategorien-Liste GET /api?mode=get_config → Konfiguration GET /api?mode=queue → Download-Queue GET /api?mode=history → Download-Verlauf GET /api?mode=queue&name=delete&value=ID → Paket löschen POST /api → Fake-NZB-Datei einreichen (Upload) GET /api?mode=addurl&name= → URL als Download hinzufügen # JDownloader-Konfiguration (Web-UI intern) POST /api/jdownloader/verify → Credentials prüfen POST /api/jdownloader/save → Credentials + Gerät speichern # Hostnamen POST /api/hostnames → Hostnamen speichern POST /api/hostnames/import-url → Hostnamen von URL importieren POST /api/hostnames/check-credentials/ → Login-Session prüfen # Benachrichtigungen POST /api/notifications/settings → Einstellungen speichern POST /api/notifications/test → Test-Nachricht senden # Timeouts POST /api/timeouts/settings → Slow-Mode konfigurieren # Sonstiges POST /api/restart → Quasarr neu starten POST /api/flaresolverr → FlareSolverr-URL setzen ``` --- ## Timeout / Slow-Mode Quasarr hat für verschiedene Operationen konfigurierbare Timeouts. Im Slow-Mode werden Timeouts mit einem Multiplikator verlängert — für langsame Seiten sinnvoll, verlängert aber die Suche. --- ## Häufige Probleme & Lösungen | Problem | Ursache | Lösung | |---------|---------|--------| | Keine Suchergebnisse | Keine Hostnames gesetzt | Mindestens einen Hostname konfigurieren | | AL-Seite funktioniert nicht | FlareSolverr fehlt oder falsch | FlareSolverr-URL prüfen (mit `/v1` am Ende) | | JDownloader nicht verbunden | JD läuft nicht / nicht eingeloggt | JD starten, my.jdownloader.org Status prüfen | | CAPTCHA-Links hängen | Manuelles Lösen nötig | `/captcha`-Route aufrufen und lösen | | `INTERNAL_ADDRESS` falsch | Radarr/Sonarr kann Quasarr nicht erreichen | IP/Port prüfen, Firewall/Docker-Netzwerk checken | | Sonarr findet keine Anime-Episoden | Serientyp falsch | Serientyp auf "Standard" setzen | | Login-Fehler bei Quelle | Falsche Credentials oder Session abgelaufen | Im Hostnames-UI "Check & Save Session" | --- ## Eigene Hoster entwickeln Quasarr erkennt neue Quellen **automatisch** per Plugin-Discovery. Es braucht zwei neue Python-Dateien: ``` quasarr/search/sources/.py → Suche + Feed (AbstractSearchSource) quasarr/downloads/sources/.py → Link-Extraktion (AbstractDownloadSource) ``` Das Kürzel (`initials`) entspricht dem Dateinamen und erscheint automatisch im Hostnames-UI nach einem Neustart. **Bei Login-Quellen zusätzlich:** ``` quasarr/providers/sessions/.py → Session/Login-Provider quasarr/storage/config.py → "" Section in _DEFAULT_CONFIG ergänzen ``` Vollständige Anleitung mit Templates: `references/custom_hoster_development.md` --- ## Referenz-Dateien - `references/docker-compose-full.yml` — vollständiges Docker-Compose-Beispiel - `references/custom_hoster_development.md` — Anleitung + Templates für eigene Hoster