Rosub für Jellyfin — Installationsanleitung

Installation

Du brauchst Jellyfin Server 12.2 oder neuer und ein MediaLab-Works-Konto mit einer Lizenz, die das Plugin abdeckt (ein aktives Abonnement, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums, das Jellyfin-Paket oder den kostenlosen 30-tägigen Testzeitraum).

Über dein Plugin-Repository (empfohlen). Jellyfin installiert und aktualisiert das Plugin dann von selbst.

1. Öffne in deinem MediaLab-Works-Konto Licenses → Jellyfin plugin repository und klick auf Create address. Kopier es: Es ist privat (es enthält ein Token), also teil es nicht; du kannst es jederzeit neu erzeugen oder widerrufen.
2. Öffne in Jellyfin Dashboard → Plugins → Repositories, klick auf +, gib einen Namen ein (zum Beispiel MediaLab Works), füg die Adresse ein und speicher.
3. Find in Dashboard → Plugins → Catalog Rosub by MediaLab, klick auf Install und starte Jellyfin neu.

Das Repository listet nur die Plugins, die deine Lizenzen abdecken, und nur die erlaubten Versionen. Seine Download-Links sind signiert und laufen nach wenigen Stunden ab, sodass Jellyfin immer eine aktuelle Liste liest.

Über den öffentlichen Katalog. https://medialab.works/jellyfin/manifest.json listet jedes veröffentlichte MediaLab-Works-Plugin mit seinem öffentlichen Build; medialab Server fügt ihn von selbst hinzu. Du kannst ihn genauso hinzufügen, um ein Plugin zu installieren, bevor du einen Schlüssel hast: Das Plugin fragt dann auf seiner Lizenzseite nach der Lizenz oder startet den Testzeitraum. Bei einer Lifetime-Lizenz mit abgelaufenem Update-Zeitraum bleib bei deinem privaten Repository, das nur die Versionen anbietet, die deine Lizenz erlaubt.

Manuell aus einer Zip-Datei.

1. Lade in Account → Licenses jf-rosub_x.y.z.zip herunter (der SHA-256 der Datei wird neben der Schaltfläche angezeigt).
2. Entpack es in einen neuen Ordner Rosub by MediaLab_x.y.z.0 im Jellyfin-Plugins-Ordner:
   • Linux (Paket): /var/lib/jellyfin/plugins/
   • Docker (offizielles Image): /config/plugins/ im Config-Volume
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Starte Jellyfin neu.

Lizenzaktivierung

1. Öffne die Plugin-Seite unter Dashboard → Plugins → Rosub by MediaLab und klick auf Open License page.
2. Füg deinen Lizenzschlüssel ein und klick auf Activate with key. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Jellyfin-Server und zeigt die Lizenz als Active an.
3. Noch kein Schlüssel? Gib auf derselben Seite deine E-Mail ein und starte den kostenlosen 30-tägigen Testzeitraum (Karte erforderlich, heute nichts zu zahlen) oder kauf eine Lizenz; das Plugin aktiviert sich, wenn die Zahlung fertig ist.

Die Lizenz wird einmal am Tag und bei jedem Jellyfin-Start geprüft. Ohne Internet arbeitet das Plugin noch 7 Tage nach der letzten erfolgreichen Prüfung weiter. Ohne gültige Lizenz stoppt das Plugin seine Arbeit, und nur seine License-Seite funktioniert weiter (Test, Schlüssel, Verlängerung); es wird nichts gelöscht, und alles läuft weiter, sobald die Lizenz wieder gültig ist. Move license (release this server) auf derselben Seite gibt den Schlüssel für einen anderen Server frei.

Updates und Rollback

• Aus dem Repository: Jellyfin zeigt neue Versionen unter Dashboard → Plugins an und kann das Plugin automatisch aktualisieren; starte Jellyfin neu, um die neue Version zu laden.
• Über die License-Seite des Plugins: Mit gültiger Lizenz installiert Install update die neueste Version, die deine Lizenz erlaubt, und Roll back to x.y.z geht zur vorherigen Version zurück (zum Beispiel, wenn nach einem Update etwas nicht mehr funktioniert). Starte Jellyfin danach neu. Beide Pakete werden gegen die vom Lizenzserver veröffentlichte Prüfsumme geprüft.
• Eine Lifetime-Lizenz erhält die Versionen, die während ihres Update-Zeitraums veröffentlicht wurden; danach arbeitet das Plugin mit der letzten erlaubten Version weiter.
• Nach Roll back to x.y.z ist Jellyfins automatische Aktualisierung für dieses Plugin ausgeschaltet, bis du auf der License-Seite wieder Install update ausführst, sodass die geplante Aufgabe Update Plugins (beim Start und täglich) die neuere Version nicht zurückholt.
• Lifetime-Lizenz und automatische Updates. Der öffentliche Jellyfin-Katalog (https://medialab.works/jellyfin/manifest.json) bietet immer die neueste Version an. Ist der Update-Zeitraum einer Lifetime-Lizenz abgelaufen, sind danach veröffentlichte Versionen nicht lizenziert: Installiert Jellyfins automatische Plugin-Aktualisierung eine davon, stoppt das Plugin mit „version not licensed", bis du über Roll back to x.y.z auf seiner License-Seite zurückgehst oder einen Update-Pass kaufst. Um das zu vermeiden, lass Jellyfin dieses Plugin nicht automatisch aktualisieren: Füg dein privates Plugin-Repository hinzu, das nur die Versionen anbietet, die deine Lizenz erlaubt, statt des öffentlichen Katalogs, oder entfern die Auslöser der geplanten Aufgabe Update Plugins unter Dashboard → Scheduled Tasks (das stoppt automatische Updates für jedes Plugin).

Quellcode

Der GPL-3.0-Quellcode jeder Version liegt in Account → Licenses (Source code) neben dem Download als .tar.gz-Archiv, das aus dem exakten Commit dieser Version erstellt wurde.

Konfiguration

Öffne Dashboard → Rosub.

1. Trag deinen subs.ro-API-Schlüssel ein (subs.ro → My account → API) und speicher. Ohne ihn macht das Plugin nichts.
2. Wähl die Bibliotheken, in denen gearbeitet werden soll (leer = alle Film- und Serienbibliotheken), und den Match-Modus: strict (Standard), relaxed oder any.
3. Optional: den OpenSubtitles.com-Fallback mit deinem API-Schlüssel, das tägliche Anfragebudget und die Reserve für neue Titel.

Tägliche Nutzung

• Neue Titel werden wenige Minuten nach dem Hinzufügen automatisch bearbeitet; die geplante Aufgabe Missing Romanian subtitles läuft täglich um 04:00 Uhr (du kannst sie aus Dashboard → Scheduled Tasks starten).
• In den Edit subtitles → Search eines Titels erscheinen Rosub-Ergebnisse neben den anderen Anbietern.
• Die Plugin-Seite zeigt das Journal: was heruntergeladen und was (und warum) abgelehnt wurde.

Fehlersuche

• Es wird nichts heruntergeladen: Prüf den API-Schlüssel und ob das Tagesbudget aufgebraucht ist (subs.ro antwortet am Limit mit 429; der Zähler setzt sich täglich zurück).
• Der Untertitel wird nicht angezeigt: Jellyfin erkennt ro und rum als Rumänisch; aktualisiere die Metadaten des Titels, wenn er während des Downloads geöffnet war.