Enigma2 Smart-Home-Integration, kostenlos und Open Source
Enigma2-Receiver über OpenWebif: Standby, Lautstärke, Kanäle, Programmführer, Nachrichten am TV.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Verfolge und steuere deine Enigma2-Receiver für Satellit, Kabel oder Antenne (VU+, Dreambox, Zgemma, Octagon, GigaBlue, Edision…) aus Gladys, über dein lokales Netzwerk und ihre Weboberfläche OpenWebif: einschalten oder in den Standby schicken, Lautstärke einstellen, Kanal aus deinen Favoriten wählen, Kanal und Sendung auf dem Bildschirm sehen, wissen, wann eine Aufnahme läuft, und eine Nachricht auf dem Fernseher anzeigen, wenn es an der Tür klingelt.
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde mit den von OpenWebif dokumentierten Antworten und mit echten, von den Projekten Home Assistant und openwebifpy veröffentlichten Antworten gebaut und getestet, nicht mit einem echten Receiver. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.
Diese Integration ist mit keinem Receiver-Hersteller verbunden.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Einen Receiver mit einem Enigma2-Image (openATV, OpenPLi, OpenViX, VTi,
Dreambox OS mit OpenWebif…) und dem Plugin OpenWebif, das bei den
meisten Images installiert und aktiv ist. Öffne
http://<Adresse des Receivers>/im Browser: Erscheint die OpenWebif-Seite, kann die Integration sie erreichen. - Receiver und Gladys im selben Netzwerk. Eine feste IP-Adresse für den Receiver (DHCP-Reservierung im Router) erspart Überraschungen.
- Falls OpenWebif eine Anmeldung verlangt: den Benutzer (meist
root) und sein Passwort.
Einrichtung
In Gladys Integrationen → Von GitHub installieren, dann die Integration Enigma2 und ihren Reiter Konfiguration öffnen. Bis zu drei Receiver, jeweils mit:
- Adresse: IP-Adresse oder Name des Receivers, zum Beispiel
192.168.1.20. Setzehttps://davor für HTTPS und:Portdahinter, wenn OpenWebif nicht auf dem Standard-Port lauscht (192.168.1.20:8080). - Benutzer und Passwort: nur wenn OpenWebif eine Anmeldung verlangt.
Ist nur das Passwort ausgefüllt, wird der Benutzer
rootverwendet. - Name: der Name des Geräts in Gladys; leer, Marke und Modell, die der Receiver meldet.
Die Optionen gelten für alle Receiver:
- Selbstsigniertes Zertifikat akzeptieren: OpenWebif liefert HTTPS mit einem selbstsignierten Zertifikat. Nur für deine eigenen Receiver ankreuzen.
- Favoriten-Bouquet: das TV-Bouquet für die Kanalliste, mit seinem Namen, wie der Receiver ihn anzeigt. Leer: das erste TV-Bouquet.
- Aktualisierungsintervall: 10 Sekunden, 30 Sekunden (Standard) oder 1 Minute.
- Sprache der Texte: die Namen der Funktionen beim Hinzufügen eines Geräts und die als Zustand veröffentlichten Texte (Kanal, Sendung). Standardmäßig Französisch.
Speichere und drücke dann Receiver testen: eine Zeile pro Receiver, mit Modell, OpenWebif-Version und Anzahl gefundener Kanäle, oder was schiefging. Geh dann in den Reiter Erkennung und füge jeden Receiver zu Gladys hinzu.
Das Gerät jedes Receivers
Ein Gerät pro Receiver, erkannt an der MAC-Adresse, die er meldet (dasselbe Gerät, auch wenn sich seine Adresse ändert).
| Funktion | Was sie tut |
|---|---|
| Ein / Standby | Ein oder Standby. Deep-Standby wird nie verwendet: Der Receiver ließe sich nicht mehr wecken. |
| Lautstärke | Die Lautstärke des Receivers, 0 bis 100 %. |
| Lautstärke höher / niedriger | Tasten, je eine Stufe. |
| Stumm | Eine Taste: Jeder Druck schaltet den Ton aus oder wieder ein. |
| Nächster / voriger Kanal | Tasten, innerhalb des Favoriten-Bouquets (vom letzten Kanal geht es zum ersten). |
| Letzter Kanal | Eine Taste: zurück zum zuvor gesehenen Kanal. |
| Kanalnummer | Die Position des Kanals im Favoriten-Bouquet; eine eingegebene Nummer schaltet dorthin. |
| Lieblingskanäle | Die Liste der Kanäle des Bouquets: Die Auswahl schaltet um. |
| Aktueller Kanal | Sein Name, „Standby“ oder „Nicht erreichbar“. |
| Aktuelle Sendung | Beginn, Ende und Titel, aus dem Programmführer des Receivers. |
| Nächste Sendung | Dasselbe für die Sendung danach. |
| Aufnahme läuft | Ja, solange der Receiver aufnimmt (auch aus dem Standby). |
Ein Receiver, der zwei Abfragen nacheinander nicht beantwortet (ausgeschaltet, im Deep-Standby, vom Netzwerk getrennt), wird im Standby mit dem Kanal „Nicht erreichbar“ angezeigt, bis er wieder antwortet.
Dashboard
Das Widget Enigma2-Receiver zeigt für den in seinen Einstellungen gewählten Receiver: Kanal, aktuelle und nächste Sendung, die Lautstärke (live), den Status, die Aufnahme und den Ton, und vier Tasten: Ein / Standby, Kanal −, Kanal + und Stumm. Im Standby bleibt nur die Ein-Taste.
Die Funktionen des Geräts lassen sich auch in die üblichen Geräte-Widgets setzen: Lautstärkeregler, Kanalliste, Fernbedienungstasten.
Szenen
Auslöser
Keine, mit Absicht: Jede Änderung, auf die sich das Warten lohnt, ist ein Zustand des Geräts, den der Szenen-Editor schon anbietet („der Receiver wird eingeschaltet“, „die Aufnahme beginnt“, „der aktuelle Kanal ist…“).
Aktionen
- Nachricht am TV anzeigen: ein Text über dem Bild, als Information, Warnung oder Alarm, für eine bestimmte Anzahl Sekunden (0: bis zum Schließen mit der Fernbedienung). Szenenvariablen sind im Text erlaubt.
- Auf Kanal umschalten: über seine Nummer im Favoriten-Bouquet oder seinen Namen (Groß- und Kleinschreibung sowie Akzente egal, der Anfang des Namens genügt). Seine Ausgabe, der Kanalname, steht den folgenden Aktionen der Szene zur Verfügung.
Die übliche Aktion Gerät steuern schaltet ein und aus und regelt die Lautstärke.
Szenen-Ideen
- Türklingel: Wenn es klingelt, „Jemand ist an der Tür“ 15 Sekunden lang als Warnung auf dem TV anzeigen.
- Gute Nacht: Um 1 Uhr den Receiver in den Standby schicken, falls er noch läuft.
- Nachrichtenzeit: Werktags um 20 Uhr, wenn der Receiver läuft, auf deinen Nachrichtensender umschalten.
- Waschmaschine: Wenn die Leistung der Waschmaschinen-Steckdose abfällt, „Die Wäsche ist fertig“ auf dem TV anzeigen.
Aktualisierung und Last
Die Integration liest jeden Receiver selbst, im gewählten Intervall: ein
Aufruf von /api/statusinfo, dazu /api/getcurrent (Programmführer), wenn er
eingeschaltet ist — zwei kleine Anfragen an ein Gerät deines lokalen Netzwerks,
ohne Kontingent und ohne Cloud. Das Favoriten-Bouquet wird stündlich neu
gelesen (und bei Receiver testen). Nur Änderungen gehen an Gladys, dazu alle
sechs Stunden ein unveränderter Wert. Ein Receiver wird erst gelesen, wenn sein
Gerät zu Gladys hinzugefügt wurde.
Fehlerbehebung
- „Kein Receiver antwortet“: Prüfe die Adresse im Browser eines Computers im selben Netzwerk; prüfe, ob OpenWebif auf dem Receiver aktiv ist (Menü → Plugins). Ein Receiver im Deep-Standby antwortet nicht.
- „Ein Receiver lehnt Benutzer oder Passwort ab“: OpenWebif verlangt eine
Anmeldung; trage den Benutzer (meist
root) und das Passwort des Receivers ein. - HTTPS schlägt fehl: Kreuze Selbstsigniertes Zertifikat akzeptieren an oder nutze die HTTP-Adresse.
- Kanalliste leer oder falsch: Trage im Favoriten-Bouquet den genauen Namen eines TV-Bouquets des Receivers ein, drücke Receiver testen und aktualisiere das Gerät im Reiter Erkennung.
- „Kein Programmführer“: Der Receiver hat keine EPG-Daten für diesen Kanal (häufig bei manchen Lokal- oder Radiosendern).
- Ausführliche Protokolle:
LOG_LEVEL=debugam Container der Integration.
Grenzen
- Ohne die Hardware entwickelt: getestet mit dokumentierten und veröffentlichten OpenWebif-Antworten, nicht mit einem echten Receiver.
- Bis zu drei Receiver. Nur TV-Bouquets werden angeboten, höchstens 200 Kanäle.
- Ein Receiver im Deep-Standby lässt sich nicht über das Netzwerk wecken (die meisten unterstützen kein Wake-on-LAN): Nutze den Standby.
- Die Receiver werden nicht automatisch gefunden: Gib ihre Adresse ein.
- Kein Senderlogo (Picon) und kein Screenshot, keine Verwaltung von Timern.
- Die Namen der Funktionen werden beim Hinzufügen festgelegt: Ändere die Sprache vorher.
Konfigurationseinstellungen
Diese Einstellungen fragt Enigma2 in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine Receiver | section | Nein | Enigma2-Receiver (VU+, Dreambox, Zgemma, Octagon, GigaBlue…) mit dem OpenWebif-Plugin, das die meisten Images mitbringen. Bis zu drei Receiver. Mit keinem Hersteller verbunden. |
| Adresse | string | Ja | IP-Adresse oder Name des Receivers, mit https:// für HTTPS und :Port, falls nicht Standard. |
| Benutzer | string | Nein | Nur wenn OpenWebif eine Anmeldung verlangt (bei den meisten Images „root“). Sonst leer. |
| Passwort | secret | Nein | Das Passwort dieses Benutzers auf dem Receiver. Leer, wenn OpenWebif keins verlangt. |
| Name | string | Nein | Name des Geräts in Gladys. Leer: Marke und Modell des Receivers. |
| Receiver 2 (optional) | section | Nein | Dieselben Felder für einen weiteren Receiver bei dir zu Hause. |
| Adresse | string | Nein | IP-Adresse oder Name des Receivers, mit https:// für HTTPS und :Port, falls nicht Standard. |
| Benutzer | string | Nein | Nur wenn OpenWebif eine Anmeldung verlangt (bei den meisten Images „root“). Sonst leer. |
| Passwort | secret | Nein | Das Passwort dieses Benutzers auf dem Receiver. Leer, wenn OpenWebif keins verlangt. |
| Name | string | Nein | Name des Geräts in Gladys. Leer: Marke und Modell des Receivers. |
| Receiver 3 (optional) | section | Nein | Dieselben Felder für einen weiteren Receiver bei dir zu Hause. |
| Adresse | string | Nein | IP-Adresse oder Name des Receivers, mit https:// für HTTPS und :Port, falls nicht Standard. |
| Benutzer | string | Nein | Nur wenn OpenWebif eine Anmeldung verlangt (bei den meisten Images „root“). Sonst leer. |
| Passwort | secret | Nein | Das Passwort dieses Benutzers auf dem Receiver. Leer, wenn OpenWebif keins verlangt. |
| Name | string | Nein | Name des Geräts in Gladys. Leer: Marke und Modell des Receivers. |
| Optionen | section | Nein | Gelten für alle Receiver. |
| Selbstsigniertes Zertifikat akzeptieren | boolean | Nein | Für https://-Adressen: OpenWebif liefert ein selbstsigniertes Zertifikat. Nur für deine eigenen Receiver ankreuzen. |
| Favoriten-Bouquet | string | Nein | Name des TV-Bouquets für die Kanalliste, wie auf dem Receiver angezeigt. Leer: das erste. |
| Aktualisierungsintervall | select | Nein | Wie oft jeder Receiver gelesen wird (zwei kleine Anfragen). |
| Sprache der Texte | select | Nein | Namen der Funktionen beim Hinzufügen eines Geräts und als Zustand veröffentlichte Texte (Kanal, Sendung). |
So installierst du Enigma2 in Gladys
- Öffne in Gladys Integrationen: Enigma2 erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-enigma2:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-enigma2.
Enigma2 benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Enigma2 ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation