Das Problem
Neu, aber unsichtbar
Ein frischer Untertitel taucht erst nach dem nächsten Scan im Player auf. Sublarr stößt den Refresh für genau diese Folge an — bei Plex einen Scan nur ihres Ordners.
Zu viele Spuren
Eingebettete Untertitel in Sprachen, die niemand liest, füllen die Auswahl. Sublarr kann sie aus der Datei entfernen — das Original bleibt 7 Tage im Papierkorb.
Auch ohne *arr
Keine Sonarr- oder Radarr-Instanz? Sublarr überwacht Ordner auch direkt im Standalone-Modus.
So richtest du es ein
- 01 Container mit der Datei unten starten — mit demselben Medienordner, den Jellyfin oder Emby einbindet.
- 02 Unter Einstellungen → Verbindungen → Medienserver den Server mit URL und API-Key anlegen. Der Typ Jellyfin/Emby deckt beide ab.
- 03 Sonarr/Radarr verbinden oder Standalone-Ordner anlegen — ab dann folgt auf jeden geschriebenen Untertitel ein Refresh.
docker-compose.yml
Ein Container, zwei Volumes. /path/to/media durch deinen Medienordner ersetzen, PUID/PGID auf deinen Benutzer setzen (id zeigt die Werte).
services:
sublarr:
image: ghcr.io/abrechen2/sublarr:1.20.0
container_name: sublarr
ports:
- "5765:5765"
volumes:
- ./config:/config
# derselbe Medienordner, den Jellyfin oder Emby einbindet
- /path/to/media:/media:rw
environment:
- PUID=1000
- PGID=1000
restart: unless-stopped Starten und prüfen:
docker compose up -d
curl http://<host>:5765/api/v1/health Die Antwort enthält {"status":"healthy","version":"…", …}
Grenzen
- Sublarr spielt nichts ab und ersetzt keinen Medienserver. Es verwaltet die Untertitel-Dateien, die Jellyfin oder Emby dann anzeigen.
- Findet Sublarr die Folge im Medienserver nicht über ihren Pfad, liest Jellyfin oder Emby die ganze Bibliothek neu ein, Plex die Bibliotheken desselben Typs — langsamer, aber der Untertitel kommt an.
- Spuren entfernen heißt, die Videodatei neu zu schreiben. Das ist eine bewusste Einstellung, kein Standard, und braucht Platz für die Kopie.
Wenn es hakt
Der Test erreicht den Server nicht
Die URL muss aus dem Sublarr-Container erreichbar sein (Standardport 8096). Den API-Key legst du im Jellyfin- bzw. Emby-Dashboard unter API-Schlüssel an.
Statt der Folge wird die ganze Bibliothek gescannt
Jellyfin sieht die Datei unter einem anderen Pfad als Sublarr. Beim Medienserver-Eintrag ein Path-Mapping im Format von:nach setzen. Bindet der Server jede Bibliothek unter einer eigenen Wurzel ein, trennst du mehrere Paare mit ; — das längste passende gewinnt, und ein Paar gilt nur für ganze Ordner.
Der Untertitel ist da, wird aber nicht angezeigt
Meist Dateirechte: PUID und PGID so setzen, dass der Medienserver die geschriebenen Dateien lesen darf.
Dein Medienserver bleibt, wie er ist
Sublarr kommt daneben, nicht an seine Stelle. Ein Container, ein API-Key.