Jellyfin Live TV einrichten mit Enigma2-Receiver (Vu+): Sender, EPG und Picons über Headend

Warum deinen eigenen Receiver als Tuner nutzen

Wenn du bereits eine Enigma2-Box (Vu+, Zgemma, GigaBlue und ähnliche) für frei empfangbare oder lizenzierte Sender betreibst, besitzt du schon den schwierigsten Teil eines Live-TV-Setups: den Tuner und die Senderliste. Headend verbindet diesen Receiver über OpenWebif mit Jellyfin, sodass Sender, Programmführer und Senderlogos alle aus derselben Box kommen. Das Plugin verkauft oder liefert nichts: Headend stellt keine Sender bereit, sondern macht nur die sichtbar, die dein Receiver ohnehin empfängt.

Der Stream läuft über den Jellyfin-Server, sodass Apps nie die Adresse des Receivers erfahren. Mehrere Zuschauer desselben Senders teilen sich einen Tuner, und ein belegter Tuner liefert einen klaren Fehler statt eines stillen Fehlschlags. Die vollständige Funktionsliste findest du auf der Produktseite; dieses Tutorial ist der praktische Weg von null bis zum funktionierenden Programmführer.

Voraussetzungen

Jellyfin Server 12.2 oder neuer, unter Linux, Windows oder Docker.
Ein Enigma2-Receiver mit aktiviertem OpenWebif, der vom Jellyfin-Server aus erreichbar ist, meist im selben Netzwerk. OpenWebif lauscht normalerweise auf Port 80 und streamt auf Port 8001.
jellyfin-ffmpeg, der ffmpeg-Build, der mit Jellyfin ausgeliefert wird.
Ein MediaLab Works Konto mit einer Lizenz, die das Plugin abdeckt: ein aktives Abo, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums, das Jellyfin-Bundle oder die kostenlose 30-Tage-Testversion.
Optional: root-SSH zum Receiver (passwortlos oder per Schlüssel), wenn du den Receiver-Watchdog nutzen willst. Er ist bei Neuinstallationen aus.

Schritt 1 — Headend installieren

Der empfohlene Weg ist dein privates Plugin-Repository, sodass Jellyfin das Plugin selbst installiert und aktualisiert.

Öffne in deinem MediaLab Works Konto Lizenzen → Jellyfin plugin repository und klicke auf Create address. Kopiere sie; sie enthält ein Token, halte sie also geheim.
Öffne in Jellyfin Dashboard → Plugins → Repositories, klicke auf +, gib einen Namen ein (zum Beispiel MediaLab Works), füge die Adresse ein und speichere.
Suche unter Dashboard → Plugins → Katalog nach Headend by MediaLab, klicke auf Install und starte Jellyfin neu.

Wenn du eine manuelle Installation bevorzugst, lade das Zip unter Konto → Lizenzen herunter, entpacke es in einen neuen Ordner namens Headend by MediaLab_x.y.z.0 im Jellyfin-Plugin-Ordner (/var/lib/jellyfin/plugins/ bei einer Linux-Paketinstallation, /config/plugins/ im offiziellen Docker-Image, %ProgramData%\Jellyfin\Server\plugins\ unter Windows) und starte Jellyfin neu. Die Anleitung listet die genauen Pfade und die Option für den öffentlichen Katalog.

Schritt 2 — Lizenz aktivieren

Öffne Dashboard → Plugins → Headend by MediaLab und klicke auf Open License page. Füge deinen Lizenzschlüssel ein und klicke auf Activate with key; das Plugin bindet den Schlüssel an diesen Server und zeigt die Lizenz als Active an. Noch kein Schlüssel? Gib auf derselben Seite deine E-Mail-Adresse ein, um die 30-Tage-Testversion zu starten. Die Lizenz wird einmal täglich und bei jedem Jellyfin-Start geprüft; ohne Internet funktioniert das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage weiter.

Schritt 3 — Receiver als Tuner hinzufügen

Öffne Dashboard → Live TV und füge ein Tunergerät vom Typ Headend (Enigma2 / Vu+) hinzu.
Gib die Receiver-Adresse, den OpenWebif-Port (80), den Stream-Port (8001) sowie Benutzername und Passwort ein, falls OpenWebif danach fragt.
Wähle die Bouquets zum Import aus. Nur die ausgewählten Bouquets werden zu Sendern in Jellyfin.

Ab Version 1.0.5 wird das OpenWebif-Passwort im Plugin-Datenordner verschlüsselt gespeichert und nie an den Browser gesendet; die Seite zeigt nur „set ✓“.

Schritt 4 — Guide-Provider hinzufügen

Füge auf derselben Seite Dashboard → Live TV den Guide-Provider Headend hinzu. Der Programmführer kommt dann für jeden Sender vom Receiver. Headend aktualisiert den Programmführer alle 60 Minuten vom Receiver, und du kannst eine Aktualisierung unter Dashboard → Scheduled Tasks → Refresh Guide erzwingen.

Schritt 5 — Senderliste gestalten

Öffne Dashboard → Headend. Hier machst du aus einer rohen Receiver-Liste etwas, das ein Haushalt nutzen kann:

Unbenannte Sender ausblenden.
Die SD-Version ausblenden, wenn die HD-Version existiert.
Namen, Nummern und Reihenfolge anpassen.
Senderlogos (Picons) kommen vom Receiver; du kannst auch ein Logo per Link setzen, als Admin-Aktion, bis zu 10 MB. Das Plugin lädt keine Picon-Pakete herunter.

Halte die Liste kurz und in der Reihenfolge, in der tatsächlich gezappt wird. Eine aufgeräumte Liste entscheidet darüber, ob eine Live-TV-Quelle genutzt oder ignoriert wird.

Schritt 6 — Zugriff pro Benutzer vergeben

Neue Benutzer starten ohne Live-TV-Zugriff über Headend. Vergib ihn auf der Headend-Seite an die Konten, die ihn haben sollen. Hier werden auch Erwachsenensender behandelt: Sie liegen hinter einer PIN, die pro Benutzer für begrenzte Zeit freigeschaltet wird. Ab Version 1.0.6 haben neue PINs mindestens 6 Ziffern, es wird nur ein PBKDF2-SHA256-Hash gespeichert, und Fehlversuche werden mit wachsenden Sperrzeiten begrenzt, die einen Neustart überstehen. In Apps wird die PIN für dieses Konto über einen Browser unter /Headend/Unlock freigeschaltet.

Schritt 7 — Ansehen

Aktualisiere den Programmführer und öffne dann Live TV in Jellyfin. Sender, Programmführer und Logos werden über das Live TV des Servers ausgeliefert, daher sollte jede App mit Live TV funktionieren; Jellyfin Web ist der verifizierte Client (HD-Wiedergabe im Bereich von 4,4–4,7 s in den veröffentlichten Tests). Bei offiziellem Jellyfin wird der Link zur TV-Seite manuell in config.json unter menuLinks hinzugefügt; auf medialab Server erscheint er automatisch.

Tipps und Fehlerbehebung

Keine Sender. Prüfe, ob OpenWebif in einem Browser vom Jellyfin-Server aus unter der eingegebenen Adresse aufgeht. Wenn der Server es nicht erreicht, erreicht Jellyfin es auch nicht.
Ein Sender spielt nicht. Ein Tuner kann jeweils nur einen Transponder empfangen; eine Aufnahme oder ein anderer Zuschauer auf einem anderen Transponder kann ihn belegen. Das ist erwartetes Verhalten, kein Plugin-Fehler.
Ein Benutzer sieht kein Live TV. Gib dem Benutzer den Zugriff auf der Headend-Seite; neue Benutzer starten ohne ihn.
Leerer Programmführer. Stelle sicher, dass der Headend-Guide-Provider unter Dashboard → Live TV hinzugefügt ist, und starte dann Refresh Guide unter Scheduled Tasks. Der Programmführer wird alle 60 Minuten vom Receiver geholt.
OpenWebif-Stream funktioniert nicht. Prüfe den Stream-Port (standardmäßig 8001) und eine eventuelle OpenWebif-Authentifizierung erneut. Die Receiver-Adresse wird nie an Clients weitergegeben, teste also von der Jellyfin-Server-Seite aus, nicht von einem Handy.
Watchdog und SSH. Der Receiver-Watchdog ist bei Neuinstallationen aus. Wenn du ihn aktivierst, wird der SSH-Hostkey ab Version 1.0.5 verifiziert: Er wird bei der ersten Verbindung in ssh/known_hosts im Datenordner gespeichert, und wenn er sich ändert, wird der Befehl nicht gesendet. Du kannst den gespeicherten Fingerprint auf der Seite ansehen und vergessen.
Updates. Wenn du eine Lifetime-Lizenz über ihren Update-Zeitraum hinaus nutzt, bleib bei deinem privaten Repository, damit Jellyfin keine Versionen zieht, die deine Lizenz nicht abdeckt. Roll back to x.y.z auf der Lizenzseite kehrt zur vorherigen Version zurück und schaltet automatische Updates für das Plugin bis zum nächsten Install update ab. Das Changelog zeigt, was sich in jeder Version geändert hat.

Fazit

Headend erledigt eine Aufgabe: Es macht den Receiver, den du bereits besitzt, zu einer vollwertigen Live-TV-Quelle in Jellyfin, mit eigenen Bouquets, Programmführer und Picons, und es hält die Receiver-Adresse auf der Serverseite. Richte Tuner und Guide-Provider ein, investiere zehn Minuten in die Senderliste, vergib den Zugriff pro Benutzer, und du hast ein legales, selbst gehostetes TV-Setup, das sich wie jede andere Jellyfin-Bibliothek verhält. Für Details über diese Anleitung hinaus sind der Benutzerleitfaden und die Wissensdatenbank die nächsten Anlaufstellen; wenn etwas nicht passt, kontaktiere uns.

Dieser Beitrag wurde mit KI-Unterstützung auf Grundlage unserer Produktdokumentation oder der aufgeführten Quellen verfasst und vor der Veröffentlichung automatisch geprüft.