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)

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=<api-key-aus-quasarr-ui>'
      - '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)

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://<INTERNAL_ADDRESS>
• 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:

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

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=<encoded-url>   → 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/<id>  → 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

Eigene Hoster entwickeln

Quasarr erkennt neue Quellen automatisch per Plugin-Discovery. Es braucht zwei neue Python-Dateien:

quasarr/search/sources/<kürzel>.py      → Suche + Feed (AbstractSearchSource)
quasarr/downloads/sources/<kürzel>.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/<kürzel>.py  → Session/Login-Provider
quasarr/storage/config.py              → "<KÜRZEL>" 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