Häufige Fragen zu Sublarr

Sublarr ist ein selbst-gehosteter, Open-Source-Untertitel-Manager für Anime- und Media-Bibliotheken. Er läuft als Docker-Container, integriert sich in Sonarr, Radarr, Jellyfin, Emby und Plex und sucht parallel über 28 eingebaute Provider-Adapter — auf Wunsch dazu 43 Katalog-Quellen aus dem Bazarr+-Katalog —, dedupliziert per SHA-256 und priorisiert ASS-Untertitel. Optional übersetzt er via lokalem LLM (Ollama) oder Cloud-KI-APIs — das Ergebnis hängt vom gewählten Übersetzer ab, Nutzung auf eigenes Risiko.

Ehrliche Antwort zuerst: Wenn deine Bibliothek englischsprachiges Live-Action ist und Bazarr sie zuverlässig abdeckt, brauchst du Sublarr vermutlich nicht — Bazarr ist reifer, hat mehr Hände dahinter und macht diesen Job gut. Sublarr lohnt sich, wenn Anime dabei ist: absolute Folgennummerierung, AniDB-Auflösung, ASS mit erhaltenem Styling, Signs/Songs-Spuren und mehrere englische Spuren pro Datei, bei denen die falsche Wahl auseinanderdriften lässt, was du liest und was du hörst. Ebenso wenn du mehrere Sprachen mit eigenen Regeln pflegst, oder wenn für das Gesuchte gar kein Untertitel existiert und dir eine prüfbare Maschinenübersetzung lieber ist als nichts. Details unter „Scope & limitations" in der Doku.

Die LLM-Übersetzung ist standardmäßig aus — die Qualität hängt von Backend, Modell und Sprachpaar ab, Nutzung auf eigenes Risiko. Die UI-Anmeldung ist ein einziges gemeinsames Passwort: keine Benutzerkonten, keine Rollen, kein Audit-Trail; für echten Mehrbenutzerbetrieb gehört ein Reverse Proxy mit Forward-Auth davor, dessen Header Sublarr nativ liest (Authelia, authentik). Der Scheduler setzt eine einzelne Primärinstanz voraus — weitere Repliken brauchen SUBLARR_SCHEDULER_ROLE=disabled, sonst feuert jeder wiederkehrende Job doppelt. Es gibt bewusst kein Auto-Update: die Oberfläche meldet neue Versionen, ausgeführt wird das Upgrade von dir. Docker ist der unterstützte Weg; Bare-Metal wird nicht getestet. Und mehrere der 28 Provider brauchen einen Account oder API-Schlüssel — ohne Schlüssel läuft entsprechend weniger. Das Projekt wird von einer einzelnen Person gepflegt.

Verbinde Sonarr mit Sublarr per Webhook (Settings → Connect → Webhook → URL: http://sublarr:5765/api/v1/webhook/sonarr). Sobald Sonarr eine Episode importiert, triggert sie eine Suche bei Sublarr, das die 28 Provider-Adapter parallel abfragt, AniDB für absolute Folgennummern auflöst und das beste Match in den Bibliotheks-Ordner ablegt. Was dabei nicht gefunden wird, sucht der Wanted-Scanner später erneut (standardmäßig alle 24 Stunden).

Anime-Releases bündeln oft mehrere englische Spuren: Fansubs (übersetzen das japanische Original), den Dubtitle (transkribiert den englischen Dub) und reine Signs/Songs-Spuren. Wer den englischen Dub schaut, will den Dubtitle — sonst driften Gehörtes und Gelesenes auseinander. Sublarrs Dubtitle-Erkennung findet die passende Spur per Messung statt Raten: Tier 1 klassifiziert über Metadaten und Cue-Dichte, und wenn mehrere Volltext-Spuren übrig bleiben, gleicht Tier 2 sie per Whisper gegen die Dub-Audio ab. Sublarr schlägt die Spur vor und zeigt die Belege — es ändert nie still deine Dateien.

Selbst-gehostet bedeutet: keine monatlichen Kosten, keine Cloud-Abhängigkeit, vollständige Kontrolle über Untertitel-Qualität. Sublarr läuft als Docker-Container im LAN, legt Sidecar-Dateien direkt neben die Mediendateien und stößt danach einen gezielten Refresh in Jellyfin, Emby, Plex, Kodi oder Shoko an — Plex scannt dabei nur den Ordner der Folge. Versus Cloud-Diensten: keine Datenweitergabe, kein Subscription-Modell, anpassbare Scoring-Pipeline.

Ja — Sublarr unterstützt 12 Übersetzungs-Backends: DeepL, Claude, Gemini, OpenAI, DeepSeek, Mistral, ChatGPT, Google, LibreTranslate, Azure, MyMemory und Ollama (lokal). Die Qualität hängt vom gewählten Backend und Modell ab: Cloud-Backends (DeepL, Claude, Gemini) liefern die gleichmäßigsten Ergebnisse, lokale Modelle laufen komplett offline. Nutzung auf eigenes Risiko. JA→DE läuft am besten in zwei Schritten: zuerst englischen Untertitel beziehen (oft fan-subbed verfügbar), dann EN→DE übersetzen. Context-Windowing erhält Sprecher-Konsistenz.

Ja — Sublarr nutzt Ollama als lokalen LLM-Runner. Empfohlene Modelle: Qwen2.5 14B (gute Allround-Qualität, ~9 GB) oder Llama 3.1 8B (~5 GB). Beide laufen ohne Internet, ohne Daten-Weitergabe. Die Qualität hängt vom Modell ab; falls dir Qualität wichtiger ist als Offline-Betrieb, liefern die Cloud-Backends (DeepL, Claude) gleichmäßigere Ergebnisse. Setup: Ollama auf Host installieren, in Sublarr unter Settings → Translation → Backend → Ollama URL eintragen (http://host.docker.internal:11434).

Schalte Auto-Sync in den Einstellungen ein: Dann gleicht ffsubsync jeden heruntergeladenen Untertitel gegen die Tonspur ab. Sublarr übernimmt davon nur die gemessene Verschiebung — der Rest der Datei bleibt, wie er ist, Schilder, Karaoke und lange Zeilen behalten ihre Länge. Ein Ergebnis, das die Zeitachse strecken würde oder unplausibel weit verschiebt, wird verworfen, statt den Untertitel zu verschlechtern. Jeder Versuch steht mit Engine, Offset und Status im Verlauf. Gegen eine Referenz-Untertitelspur synchronisiert alass (optional); einen eigenen Offset setzt du im Waveform-Editor.

Klicke in der Library auf eine Untertitel-Datei → „Bearbeiten". Die Audio-Wellenform wird oben angezeigt, darunter eine sortierbare Cue-Liste mit ASS-Syntax-Highlighting. Cues per Drag verschieben, Snap-to-Wave aktivieren für Frame-genaue Audio-Anker. Beim Speichern werden BOM, Zeilenumbrüche, Encoding-Probleme und überlappende Cues automatisch repariert.

In Sonarr/Radarr unter Settings → Connect → +Add → Webhook. URL: http://<sublarr-host>:5765/api/v1/webhook/sonarr (bzw. /radarr). Triggers: On Import, On Upgrade. Sublarr unterstützt Multi-Instance: mehrere Sonarr-/Radarr-URLs in den Sublarr-Settings hinzufügen, Tag-basierte Sprachprofile zuweisen (z.B. Tag „anime" → DE+EN, Tag „movies" → nur DE).

Sublarr läuft auf jeder Docker-fähigen Plattform. Unraid: in der Community-Apps das Image ghcr.io/abrechen2/sublarr:latest hinzufügen, Port 5765 mappen, /config und /media Volumes setzen. Synology DSM 7 (Container Manager): docker-compose.yml laden (siehe Installation-Page). QNAP, TrueNAS Scale, Raspberry Pi (ARM64) und Cloud-Provider funktionieren identisch. RAM-Bedarf ohne Übersetzung: ~256 MB; mit lokalem LLM: 4–8 GB.

GPL-3.0 garantiert: (1) du darfst Sublarr unbegrenzt nutzen, auch kommerziell; (2) Quellcode ist und bleibt offen — keine versteckten Telemetry-Pakete oder Backdoors; (3) jeder kann Forks bauen, falls die Maintenance einschläft; (4) Modifikationen müssen unter GPL-3.0 weitergegeben werden, wenn sie veröffentlicht werden — keine Closed-Source-Übernahme deines Beitrags. Praktisch: keine Vendor-Lock-in-Risiken für deine Bibliothek.

Standardmäßig nur Provider-Anfragen (Untertitel-Suche → externe APIs wie OpenSubtitles, Addic7ed, Jimaku). Keine Crash-Reports, keine Account-Erstellung. Eine pseudonyme Nutzungsstatistik gibt es, sie ist aber opt-in und standardmäßig AUS — solange du sie nicht aktivierst, wird nichts gesendet; aktiviert ist es ein Ping alle 24 Stunden aus Enums, Booleans und groben Klassen, und der Widerruf löscht die bereits erhobenen Daten (siehe „Usage Statistics" in der Doku). Bei Cloud-Übersetzungs-Backends (Claude/Gemini/DeepL) gehen die Untertitel-Texte an den jeweiligen Anbieter — vermeidbar durch Wahl von Ollama (lokal). Konfiguration und Datenbank bleiben in /config auf deinem Host.