Headend 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 Lizenzen → Jellyfin-Plugin-Repository und klicke auf Adresse erstellen. Kopiere sie: Sie ist privat (sie enthält einen Token), teile sie also nicht; du kannst sie jederzeit neu erzeugen oder widerrufen.
2. Öffne in Jellyfin Dashboard → Erweiterungen → Repositories, klicke auf +, gib einen Namen ein (zum Beispiel MediaLab Works), füge die Adresse ein und speichere.
3. Finde im Dashboard → Erweiterungen → Katalog den Eintrag Headend by MediaLab, klicke auf Installieren und starte Jellyfin neu.

Das Repository listet nur die Plugins, die deine Lizenzen abdecken, und nur die Versionen, die sie erlauben. Seine Download-Links sind signiert und laufen nach ein paar Stunden ab, deshalb liest Jellyfin immer eine frische Liste.

Ü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 auf dieselbe Weise 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, deren Update-Zeitraum endete, bleib bei deinem privaten Repository, das nur die Versionen anbietet, die deine Lizenz erlaubt.

Manuell aus einer Zip-Datei.

1. Lade in Konto → Lizenzen jf-headend_x.y.z.zip herunter (die SHA-256 der Datei steht neben dem Button).
2. Entpacke sie in einen neuen Ordner Headend by MediaLab_x.y.z.0 im Jellyfin-Plugin-Ordner:
   • Linux (Paket): /var/lib/jellyfin/plugins/
   • Docker (offizielles Image): /config/plugins/ im Konfigurations-Volume
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Starte Jellyfin neu.

Lizenzaktivierung

1. Öffne die Plugin-Seite unter Dashboard → Erweiterungen → Headend by MediaLab und klicke auf Open License page.
2. Füge deinen Lizenzschlüssel ein und klicke 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-Adresse ein und starte den kostenlosen 30-tägigen Testzeitraum (Karte erforderlich, heute nichts zu zahlen) oder kaufe eine Lizenz; das Plugin aktiviert sich, sobald die Zahlung erledigt ist.

Die Lizenz wird einmal am Tag und bei jedem Start von Jellyfin geprüft. Ohne Internet funktioniert 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 (Testzeitraum, 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 → Erweiterungen an und kann das Plugin automatisch aktualisieren; starte Jellyfin neu, um die neue Version zu laden.
• Über die Lizenzseite 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 nach beidem neu. Beide Pakete werden gegen die Prüfsumme geprüft, die der Lizenzserver veröffentlicht.
• Eine Lifetime-Lizenz erhält die Versionen, die während ihres Update-Zeitraums erschienen sind; danach läuft das Plugin mit der letzten Version weiter, die es nutzen darf.
• Nach Roll back to x.y.z ist die automatische Aktualisierung von Jellyfin für dieses Plugin ausgeschaltet, bis zum nächsten Install update auf der Lizenzseite, damit 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. Wenn der Update-Zeitraum einer Lifetime-Lizenz endete, sind später erschienene Versionen nicht lizenziert: Wenn Jellyfins automatische Plugin-Updates so eine Version installieren, stoppt das Plugin mit „version not licensed", bis du auf seiner Lizenzseite mit Roll back to x.y.z zurückgehst oder einen Update-Pass kaufst. Um das zu vermeiden, lass Jellyfin dieses Plugin nicht automatisch aktualisieren: Füge dein privates Plugin-Repository hinzu, das nur die Versionen anbietet, die deine Lizenz erlaubt, anstelle des öffentlichen Katalogs, oder entferne die Auslöser der geplanten Aufgabe Update Plugins unter Dashboard → Geplante Aufgaben (das stoppt automatische Updates für jedes Plugin).

Quellcode

Der GPL-3.0-Quellcode jeder Version liegt in Konto → Lizenzen (Quellcode) neben dem Download als .tar.gz-Archiv, erzeugt aus dem exakten Commit dieser Version.

Konfiguration

1. Öffne Dashboard → Live-TV, füge ein Tuner-Gerät vom Typ Headend (Enigma2 / Vu+) hinzu und gib den Receiver ein: Adresse, OpenWebif-Port (80) und Stream-Port (8001), Benutzername und Passwort, falls OpenWebif danach fragt, und die Bouquets, die importiert werden sollen.
2. Füge auf derselben Seite den Headend-Guide-Anbieter hinzu, damit die Programmzeitschrift vom Receiver kommt.
3. Öffne Dashboard → Headend, um die Kanalliste anzupassen (Namen, Nummern, Reihenfolge, Logos, Erotikkanäle) und den Benutzern, die ihn haben sollen, Live-TV-Zugriff zu geben; neue Benutzer starten ohne ihn.
4. Aktualisiere die Programmzeitschrift (Dashboard → Geplante Aufgaben → Programmzeitschrift aktualisieren); die Kanäle erscheinen im Live-TV.

Fehlerbehebung

• Keine Kanäle: Prüfe, ob sich OpenWebif in einem Browser vom Jellyfin-Server aus unter der eingegebenen Adresse öffnet.
• Ein Kanal spielt nicht ab: Ein Tuner kann jeweils nur einen Transponder empfangen; eine Aufnahme oder ein anderer Zuschauer auf einem anderen Transponder kann ihn belegen.
• Ein Benutzer sieht kein Live-TV: Gib dem Benutzer den Zugriff auf der Headend-Seite.