Rosub findet rumänische Untertitel für deine Jellyfin-Bibliothek auf subs.ro und wählt aus den heruntergeladenen Archiven die Datei aus, die für dein Release gemacht wurde – damit das Timing stimmt.
Was es macht
- Bei Neuzugang: Wenige Minuten, nachdem Jellyfin einen neuen Film oder eine neue Episode erkannt hat, durchsucht Rosub subs.ro (nach IMDb-/TMDb-ID) und speichert den Untertitel als
Name.ro.srtneben dem Video. - Täglich (geplante Aufgabe um 04:00 Uhr): wiederholt alles ohne rumänischen Untertitel, neue Titel zuerst; noch nicht gefundene Titel werden nach ein paar Tagen erneut versucht, denn Untertitel erscheinen oft erst Tage nach dem Release.
- Release-Matching: Der Dateiname wird aufgeteilt in Titel, Jahr, Staffel/Episode, Auflösung, Quelle (WEB-DL, BluRay, HDTV), Dienst, Codec und Release-Gruppe und mit jedem Untertitel verglichen; der Modus strict akzeptiert nur Untertitel, die für dasselbe Release, dieselbe Gruppe oder dieselbe Streaming-Quelle gemacht wurden.
- Sync-Prüfung: Hat das Video einen eingebetteten Untertitel, wird das Timing des Kandidaten damit verglichen; ein konstanter Versatz wird korrigiert, ein nicht synchroner Untertitel abgelehnt.
- Korrektes Rumänisch: UTF-8, mit ș und ț (Komma darunter) statt der alten Cedilla-Formen.
- OpenSubtitles.com als Fallback (optional, eigener API-Schlüssel), wenn subs.ro nichts Passendes hat.
- Manuelle Suche: Rosub erscheint als Anbieter in Jellyfins Untertitelsuche.
- Hält das Kontingent ein: subs.ro erlaubt 300 Anfragen pro Tag und Schlüssel; Rosub nutzt höchstens das von dir gesetzte Budget und behält eine Reserve für neu hinzugefügte Titel.
Voraussetzungen
- Jellyfin Server 12.2 oder neuer.
- Ein kostenloser subs.ro-API-Schlüssel (My account → API); optional ein OpenSubtitles.com-API-Schlüssel.
- Das ffprobe des Servers, für die Sync-Prüfung.
Häufige Fragen
Wie bekomme ich automatisch rumänische Untertitel in Jellyfin? Installiere Rosub und trag deinen subs.ro-API-Schlüssel in Dashboard → Rosub ein. Neue Filme und Episoden bekommen wenige Minuten nach dem Hinzufügen einen passenden rumänischen Untertitel, und die tägliche Aufgabe füllt den Rest der Bibliothek auf. Siehe die Anleitung.
Warum „exakt zum Release passend"? Ein Untertitel für ein anderes Release (andere Gruppe, andere Quelle oder anderer Schnitt) ist oft nicht synchron. Rosub wählt die Datei, die für dein Release gemacht wurde, und prüft das Timing, bevor sie sie speichert.
Was es wohin sendet
- subs.ro (
api.subs.ro) — nur mit deinem eigenen API-Schlüssel (keiner beigelegt): nur die IMDb- oder TMDb-ID des Films/der Serie (bei Episoden die Serien-ID) und die Sprache; dann der Download des gewählten Untertitels und eine Kontingentabfrage. Es werden keine Titel, Dateinamen, Release-Namen oder Hashes gesendet. - OpenSubtitles (
api.opensubtitles.com) — optional, nur mit deinem eigenen Schlüssel: Sprachen, IMDb-/TMDb-ID (oder Serien-ID + Staffel/Episode) und der OpenSubtitles-Hash der Datei (lokal aus Größe und den ersten/letzten 64 KB berechnet; der Inhalt wird nicht gesendet); optionaler Login mit deinem OpenSubtitles-Konto (Benutzername + Passwort → Token); Download vom OpenSubtitles-CDN. - Wann: ~2 Min. nach dem Hinzufügen eines Titels, täglich um 04:00 Uhr (Titel ohne Untertitel), bei manueller Suche auf dem Server; mit Tagesbudgets (subs.ro 250, OpenSubtitles 5 Anfragen standardmäßig).
- Sync-Prüfung und Release-Matching laufen lokal (ffprobe). Benachrichtigungen gehen ins lokale Aktivitätsprotokoll.
- Dazu der Lizenzierungs-Client, derselbe in jedem Plugin: siehe Lizenzierung und Datenschutz in unseren Plugins.
Lokal gespeichert: der subs.ro-API-Schlüssel, der OpenSubtitles-API-Schlüssel und das OpenSubtitles-Kontopasswort, verschlüsselt in secrets.enc.json im Plugin-Datenordner (AES-256-GCM, zufälliger Schlüssel aus secrets.key, gebunden an die Server-ID, beide Dateien Modus 600) und nie an den Browser gesendet (die Seite zeigt nur „set ✓"); der OpenSubtitles-Benutzername bleibt in der Plugin-Konfiguration (ab Version 1.1.3; frühere Versionen halten die Schlüssel und das Passwort im Klartext in der Konfiguration); state/state.json (Titel, Pfade, Status, Journal mit maximal 1000 Einträgen, Kontingente, OpenSubtitles-Session-Token); Suchcache (12 Std.) und Archive (30 Tage); Untertitel als <video>.ro.srt neben der Datei.
Client-Kompatibilität
- Untertitel werden normale externe
.srt-Dateien: 🟢 Sie erscheinen in jedem Client, der externe Untertitel anzeigt (✅ Jellyfin: echte subs.ro-Suche + Download). Einzelne native Apps: ❔ nicht getestet. - Admin-Seite: Jellyfin Web (✅ Desktop + Smartphone).
- Funktioniert mit AISub (generiert erst nach „searched, not found").
Legende: ✅ verifiziert (End-to-End- oder On-Device-Test) · 🟢 serverseitig, funktioniert mit jedem Client (by design, kein client-spezifischer Test) · ➖ nicht zutreffend · ❔ nicht getestet.
Lizenzierung
Das Plugin ist Open Source (GPL-3.0). Die fertigen Builds sind – wie der Quellcode – öffentlich. Gekauft wird das Abonnement: die Lizenz, das Plugin auf einem Jellyfin-Server zu nutzen, die Updates deines Tarifs und Support: jedes Update, solange das Abonnement aktiv ist, über dein privates Plugin-Repository, und Hilfe, wenn etwas nicht funktioniert. Das Plugin prüft den Abonnementschlüssel einmal am Tag; ohne gültiges Abonnement stoppt es, bis du erneuerst (es wird nichts gelöscht). Monatlich, jährlich oder Lifetime (Lifetime enthält ein Jahr Updates) oder enthalten im Jellyfin-Paket. 30 Tage kostenlos testen.
Quellcode. Zu jeder Version ist der vollständige zugehörige Quellcode öffentlich, neben dem Build, im Changelog und auch in deinem Konto (Account → Licenses, Source code); jedes Archiv enthält den vollständigen GPL-3.0-Text (LICENSE). Wenn du den Quellcode einer Version brauchst, die du nicht mehr herunterladen kannst, schreib uns und wir schicken ihn dir. Siehe Abschnitt 10 der EULA.