Headend — Emby Live TV aus Enigma2-Receivern

Headend ist ein Emby-Plugin, das Emby Live TV aus einem Enigma2-Receiver (Vu+ Duo 4K, Uno, Solo und ähnliche, mit VTi, OpenATV, OpenPLi …) über OpenWebif einrichtet. Die Kanäle, die dein Receiver empfängt, erscheinen in Embys Live TV mit EPG (Programmzeitschrift), Kanallogos (Picons) und Elternkontrolle.

Was es macht

• Kanalstreams aus den Tunern des Receivers, Emby-Live-TV-Kanälen zugeordnet (Bouquet-Auswahl).
• EPG (Programmzeitschrift): Programm vom Receiver plus optionale externe XMLTV-Quellen, pro Kanal zusammengeführt.
• Picons: Kanallogos vom Receiver oder von einem Link, den du angibst.
• GPU-Upscaling (optional, NVENC): SD-Kanäle werden auf dem Server hochskaliert, bevor sie die Clients erreichen.
• Adult PIN: Als Erotikkanäle markierte Kanäle verlangen in Emby eine PIN.
• Receiver-Watchdog: Erkennt einen eingefrorenen Receiver und startet enigma2 neu oder weckt ihn aus dem Standby.

Voraussetzungen

• Emby Server 4.10.1 oder neuer, Emby Premiere für Live-TV-Funktionen.
• Enigma2-Receiver mit OpenWebif 1.2.9 oder neuer, erreichbar vom Emby-Server. Getestet: Vu+ Duo 4K mit VTi 15.
• Optional: NVIDIA-GPU mit NVENC für Upscaling.
• Optional: Kurze Segmente (Schnellstart) brauchen einen Wrapper, der als root installiert wird. Der Receiver-Watchdog (optional, bei Neuinstallationen aus) braucht root-SSH zum Receiver, ohne Passwort oder mit Schlüssel.

Häufige Fragen

Wie richte ich Live TV in Emby mit einem Enigma2-Receiver ein? Installiere Headend, gib die Adresse des Receivers und den OpenWebif-Port in Dashboard → Plugins → Headend ein und wähle die Bouquets, die zu Kanälen werden. Öffne dann Live TV → Settings → Tuner devices, wo Headend als Tuner erscheint, und aktualisiere die Programmzeitschrift. Jeder Schritt steht in der Installationsanleitung.

Enthält Headend IPTV-Kanäle oder ein Abonnement? Nein. Headend streamt die Kanäle, die dein eigener Enigma2-Receiver von Satellit oder Kabel empfängt. Es verkauft oder enthält keine Kanäle, Playlisten oder IPTV-Abonnements.

Kann ich ein XMLTV-EPG nutzen? Ja. Das eigene Programm des Receivers ist standardmäßig an; du kannst externe XMLTV-URLs hinzufügen und Kanäle nach Namen oder Service-Reference zuordnen. Die Programmdaten werden pro Kanal zusammengeführt.

Kann ich Live-TV aufnehmen? Ja, Aufnahmen funktionieren wie bei jedem Emby-Tuner. Ein Tuner am Receiver trägt jeweils einen Kanal (Kanäle auf demselben Transponder können ihn sich teilen).

Was es wohin sendet

Alle Verbindungen unten starten erst mit einer gültigen Lizenz.

• Dein Enigma2-/Vu+-Receiver (OpenWebif, deine Adresse; Web-Port 80, Stream 8001; optionale Authentifizierung): Infos, Betriebszustand, Bouquets, Kanäle, Programm (alle 60 Minuten), Kanalstreams. Clients sehen die Receiver-Adresse nie — Streams laufen über den Server.
• SSH zum Receiver (der Watchdog; bei Neuinstallationen aus ab Version 0.2.9, bis der Admin ihn aktiviert, bei Updates bleibt er wie er war): TCP-/HTTP-Check alle 3 Minuten; nach 2 Fehlversuchen der Neustartbefehl per ssh (Standardbenutzer root, optionaler Schlüssel), danach Neustart; Diagnosen werden per SSH gesammelt, bevor neu gestartet wird; Standby nach 10 Minuten Leerlauf; nächtlicher Kanalscan (02–06). Der SSH-Host-Schlüssel wird ab Version 0.2.9 verifiziert (Trust on First Use): Er wird bei der ersten Verbindung gespeichert (ssh/known_hosts im Datenordner); wenn er sich ändert, wird der Befehl nicht gesendet und eine klare Meldung angezeigt; der gespeicherte Fingerabdruck kann auf der Seite angezeigt und vergessen werden.
• Internetkanäle (iptv-org) — bei Neuinstallationen aus ab Version 0.2.9 (die Checkliste zur Ersteinrichtung erklärt, was sie kontaktieren; bei Updates bleiben sie wie sie waren), sobald die Lizenz aktiv ist (Standardländer RO, MD): lädt den öffentlichen Katalog iptv-org.github.io/api/*.json herunter (höchstens stündlich, mit ETag), prüft Streams auf den Third-Party-Hosts der Kanäle (bis 64 KB, alle 24 h / 6 h) und lädt Kanallogos herunter. Diese Hosts sehen die IP-Adresse deines Servers. Kann in den Einstellungen abgeschaltet werden. Deine eigenen M3U-Listen (URL oder Datei) sind optional.
• Externes Programm (EPG) — bei Neuinstallationen aus ab Version 0.2.9 (Checkbox in der Checkliste zur Ersteinrichtung; bei Updates bleibt es wie es war), täglich um 04:00, mit 2 s zwischen den Anfragen: www.programetv.ro, www.cinemagia.ro, epgshare01.online, open-epg.com (+ dein eigenes XMLTV, standardmäßig aus). Es werden nur Programmseiten/-dateien angefragt; es werden keine Nutzerdaten gesendet. Programmbilder werden dem Server als externe URLs übergeben (der Server kann sie herunterladen).
• Logos von einem Link: Nur auf Admin-Aktion (max. 10 MB). Das Plugin lädt keine Picon-Pakete herunter.
• Lokal: nvidia-smi für die GPU-Überwachung.
• Seiten laden keine externen Ressourcen.
• Dazu der Lizenz-Client, in jedem Plugin gleich: siehe Lizenzierung und Datenschutz in unseren Plugins.

Lokal gespeichert:

• Receiver-Details (Adresse, Ports, OpenWebif-Benutzer) in der Serverkonfiguration; ab Version 0.2.9 ist das OpenWebif-Passwort im Ruhezustand verschlüsselt in secrets.enc.json im Plugin-Datenordner (AES-256-GCM, Zufallsschlüssel aus secrets.key, gebunden an die Server-ID, beide Dateien mit Modus 600) und wird nie an den Browser gesendet (die Seite zeigt nur „set ✓“); frühere Versionen halten es im Klartext (in der Live-TV-Tuner-Konfiguration). Für SSH werden nur der Schlüsselpfad und der öffentliche Host-Schlüssel des Receivers (ssh/known_hosts) gespeichert.
• PIN für Erotikkanäle: nur der PBKDF2-SHA256-Hash (200,000 Iterationen, mit Salt). Ab Version 0.2.10 haben neue PINs mindestens 6 Stellen (eine bestehende PIN funktioniert weiter), und Fehlversuche werden mit wachsenden Sperren begrenzt, die einen Neustart überleben.
• history.json: Kanalstarts der letzten 24 h und minutengenaue Nutzung (keine Benutzernamen); die Programmzeitschrift (24 h Verlauf), der iptv-org-Katalog, der Live-Puffer im Server-Cache.
• Der „Backup“-Export des Admins enthält die Plugin-Konfiguration; ab Version 0.2.10 enthält er nicht mehr den PIN-Hash (frühere Versionen schon). Adressen aus IPTV-Listen, Programmquellen und Logoquellen können das lokale Netz oder den Server selbst nicht erreichen (außer den konfigurierten Receiver), es sei denn, der Admin schaltet „Local network IPTV sources“ ein (bei einem Update automatisch angeschaltet, wenn gespeicherte Quellen bereits im lokalen Netz sind); IPTV-Adressen werden ohne Konto und Passwort geloggt.
• Die Option „no B-frames for web playback“ (standardmäßig an) ändert Embys globale Encoding-Optionen; Embys Auto-Update kann nur durch eine Admin-Aktion abgeschaltet werden.

Kompatibilität mit Clients

• Kanäle, Programmzeitschrift, Streams, die Erotikkanal-Sperre sowie Audio- und Untertitel-Einstellungen werden über das Live-TV des Servers ausgeliefert: 🟢 sollte in jeder App mit Live TV funktionieren.
• ✅ Emby Web: echte Wiedergabe mit einem Vu+ Duo 4K (VTi, OpenWebif), Kaltstart 4.4–5.7 s.
• Native Emby-Apps (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV), TV-Browser: ❔ nicht getestet.
• Nur Browser: die Admin-Seite, die Seite „TV“ (Netflix-Stil), die Seite „Erotikkanäle“. In Apps wird die PIN über einen Browser unter /Headend/Unlock freigeschaltet (pro Konto; ✅ Chrome, Handy).

Legende: ✅ verifiziert (End-to-End- oder Test auf dem Gerät) · 🟢 serverseitig, funktioniert mit jedem Client (konstruktionsbedingt, kein clientspezifischer Test) · ➖ nicht zutreffend · ❔ nicht getestet.

Lizenzierung

Eine Lizenz pro Emby-Server. Monatlich, jährlich oder als Lifetime-Lizenz, oder enthalten im Emby-Paket. 30 Tage kostenlos testen.