Orange TV Smart-Home-Integration, kostenlos und Open Source
Orange-TV-Decoder: Ein/Aus, Sender und Lautstärke aus Gladys, Fernbedienungs-Widget, Szenen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Steuere und verfolge deinen Orange-TV-Decoder (UHD 86, TV 4, TV 5, TV 6) aus Gladys, in deinem lokalen Netzwerk: einschalten oder in den Standby schicken, den laufenden Sender sehen, Sender wechseln, lauter oder leiser stellen und in deinen Szenen reagieren, wenn der Fernseher eingeschaltet wird oder der Sender wechselt.
Die Integration nutzt die lokale HTTP-API des Decoders (Port 8080), die auch die Orange-TV-App verwendet. Kein Konto, keine Cloud.
Developed without the hardware: feedback welcome. Ohne das Gerät entwickelt: Rückmeldungen sind willkommen. Die Integration wurde gegen einen Simulator gebaut und getestet, der den Antworten der Open-Source-Projekte folgt, die diese API nutzen, nicht gegen einen echten Decoder. Sag uns auf GitHub oder im Gladys-Forum, was funktioniert und was nicht.
Voraussetzungen
- Ein Orange-TV-Decoder an deiner Livebox, im selben Netzwerk wie Gladys.
- Seine IP-Adresse: in der Oberfläche der Livebox (
http://192.168.1.1) unter den verbundenen Geräten. Reserviere sie (statische DHCP-Zuweisung), damit sie sich nicht ändert. - Gladys 5.1.0 oder neuer.
Konfiguration
Unter Integrationen → Orange TV → Konfiguration:
- IP-Adresse: die Adresse des Decoders, z. B.
192.168.1.20(standardmäßig Port 8080; für einen anderen192.168.1.20:8081eingeben). - Name: der Name des Geräts in Gladys. Leer: „Orange TV“ gefolgt von der Adresse.
- Bis zu drei Decoder, einer pro Abschnitt.
- Leseintervall: wie oft die Decoder gelesen werden, von 5 Sekunden bis 1 Minute (standardmäßig 10 Sekunden). Das ist die Verzögerung, bis Gladys einen Senderwechsel per Fernbedienung sieht.
- Sprache der Namen: Sprache der Funktionsnamen und der Texte der Integration. Wähle sie, bevor du die Geräte hinzufügst: Gladys behält die Namen, die beim Anlegen vergeben wurden.
Decoder testen liest jeden Decoder und zeigt, was er anzeigt. Füge dann die Geräte im Tab Erkennung hinzu.
Geräte
Ein Gerät pro Decoder, mit diesen Funktionen:
| Funktion | Was sie tut |
|---|---|
| Ein / Standby | An (1) oder Standby (0). Ein Decoder, der nicht mehr antwortet, gilt als aus. Schaltbar: schaltet den Decoder ein oder aus. |
| Sendernummer | Nummer des Live-Senders auf der Fernbedienung, 0 wenn keiner. Schaltbar: tippt die Nummer auf der Fernbedienung. |
| Sender | Name des Senders oder was der Decoder zeigt: Startseite, Video auf Abruf, Standby, Aus. |
| Nächster Sender | Taste: nächster Sender. |
| Vorheriger Sender | Taste: vorheriger Sender. |
| Lauter | Taste: eine Lautstärkestufe mehr. |
| Leiser | Taste: eine Lautstärkestufe weniger. |
| Stumm | Taste: Ton aus oder wieder an. |
| Wiedergabe / Pause | Taste: Live-TV oder Replay pausieren und fortsetzen. |
Die Ein-Taste der Fernbedienung schaltet hin und her: Die Integration liest den Decoder zuerst und drückt sie nur bei Bedarf, „ausschalten“ schaltet also nie einen Decoder ein.
Die Sendernamen stammen aus einer in die Integration eingebauten Tabelle des Orange-Angebots (freie
Sender, die wichtigsten bis 40). Ein fehlender Sender erscheint als EPG <id> (seine Kennung im
Orange-Programmführer), mit der Nummer 0.
Widgets
Fernbedienung
Der Status des Decoders und der laufende Sender, mit vier Tasten: Einschalten (oder Standby, wenn er an ist), dann entweder Sender −, Sender + und Stumm (Standard) oder Leiser, Lauter und Stumm (Einstellung Tasten). Gladys erlaubt vier Tasten pro Widget: Stelle zwei Fernbedienungs-Widgets nebeneinander für die ganze Fernbedienung.
Lieblingssender
Vier Sendertasten, Nummern in den Widget-Einstellungen gewählt (standardmäßig TF1, France 2, France 3 und M6). Der laufende Sender trägt ein Häkchen. Ein Tippen auf einen Decoder im Standby schaltet ihn zuerst ein und tippt dann die Nummer.
Szenen-Auslöser
- Decoder eingeschaltet: Der Decoder hat den Standby verlassen. Weitergegebene Informationen: Name des Decoders, Sendernummer, Sender.
- Decoder ausgeschaltet: Der Decoder ist in den Standby gegangen oder antwortet nicht mehr (Filter
Wie). Weitergegebene Informationen: Name des Decoders, wie (
standbyoderunreachable). - Sender gewechselt: Der Decoder hat auf einen anderen Live-Sender gewechselt (Filter auf eine Sendernummer, leer: jeder). Weitergegebene Informationen: Name des Decoders, Nummer und Name des Senders, Nummer und Name des vorherigen Senders. Über die Startseite zum selben Sender zurück ist kein Wechsel; der erste Sender nach einem Start der Integration auf der Startseite oder im Standby ist einer, ohne vorherigen Sender.
Die Ereignisse werden auch für einen Decoder ausgelöst, der nicht in Gladys hinzugefügt wurde.
Szenen-Aktionen
- Decoder ein- oder ausschalten: drückt die Ein-Taste nur bei Bedarf. Ausgabe: ob die Taste gedrückt wurde.
- Sender wählen: tippt die Sendernummer auf der Fernbedienung; schaltet den Decoder vorher ein, falls er im Standby ist (etwa 6 Sekunden). Ausgaben: Nummer und Name des Senders.
- Taste drücken: OK, zurück, Menü, TV-Programm, Pfeile, Sender, Lautstärke, stumm, Wiedergabe / Pause, zurückspulen, vorspulen, aufnehmen, Video auf Abruf, Ein; bis zu 10 Mal (Lautstärkestufen).
Ohne gewählten Decoder steuern die Aktionen den ersten Decoder der Konfiguration.
Szenen-Beispiele
- Morgennachrichten: werktags um 7:00 → Sender wählen 16 (franceinfo).
- Filmabend: Decoder eingeschaltet nach 20:00 → das Licht im Wohnzimmer dimmen.
- Ruhiges Haus: Decoder ausgeschaltet → nach 5 Minuten die Steckdosenleiste des Fernsehers ausschalten.
- Kinder: Sender gewechselt auf eine bestimmte Nummer → eine Nachricht senden.
Fehlerbehebung
- „antwortet nicht (aus oder falsche Adresse)“: Prüfe die IP-Adresse in der Livebox; der Decoder muss Strom haben. Im Tiefschlaf (dem Energiesparmodus des Decoders) antwortet er nicht mehr im Netzwerk: Er erscheint dann als Aus und lässt sich nur mit seiner Fernbedienung einschalten.
- „antwortet, ist aber kein Orange-TV-Decoder“: Die Adresse gehört zu einem anderen Gerät.
- Der Sender erscheint als
EPG 1234: Der Sender steht nicht in der eingebauten Tabelle; nenne uns seine Nummer und seinen Namen in einem Issue. - Ein getippter Sender ist falsch: Die Ziffern werden im Abstand von 0,35 s getippt; sag uns, ob dein Decoder mehr braucht.
- Protokolle: Integrationen → Orange TV → Logs;
LOG_LEVEL=debugzeigt jede Lesung.
Einschränkungen
- Ohne das Gerät entwickelt: Das Lesen von Standby, Startseite und Apps stammt aus den Open-Source-Projekten, nicht aus Tests an einem echten Decoder. Der Orange-„Clé TV“ (Android TV) hat diese lokale API wahrscheinlich nicht: nicht unterstützt, bis jemand das Gegenteil bestätigt.
- Kein Programmführer: Der Decoder liefert nur die Kennung des laufenden Senders, und die Integration ruft keinen Online-Dienst von Orange auf.
- Ein Decoder im Tiefschlaf lässt sich nicht über das Netzwerk wecken.
- Keine Erkennung: Die IP-Adresse wird in der Konfiguration eingegeben.
- Die lokale API hat kein Passwort: Jeder in deinem Netzwerk kann den Decoder steuern, mit oder ohne Gladys. Die Integration sendet nur Tasten der Fernbedienung.
- Nicht mit Orange verbunden. Orange ist eine Marke von Orange SA.
Konfigurationseinstellungen
Diese Einstellungen fragt Orange TV in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine Decoder | section | Nein | Orange-TV-Decoder (UHD 86, TV 4, TV 5, TV 6) im selben Netzwerk wie Gladys. Seine IP-Adresse findest du in deiner Livebox (verbundene Geräte); reserviere sie, damit sie sich nicht ändert. Bis zu drei Decoder. |
| IP-Adresse | string | Ja | IP-Adresse des Decoders in deinem Netzwerk (standardmäßig Port 8080). |
| Name | string | Nein | Name des Geräts in Gladys. Leer: „Orange TV“ gefolgt von der Adresse. |
| Zweiter Decoder (optional) | section | Nein | Dieselben Felder, für einen weiteren Orange-TV-Decoder bei dir zu Hause. |
| IP-Adresse | string | Nein | IP-Adresse des Decoders in deinem Netzwerk (standardmäßig Port 8080). |
| Name | string | Nein | Name des Geräts in Gladys. Leer: „Orange TV“ gefolgt von der Adresse. |
| Dritter Decoder (optional) | section | Nein | Dieselben Felder, für einen weiteren Orange-TV-Decoder bei dir zu Hause. |
| IP-Adresse | string | Nein | IP-Adresse des Decoders in deinem Netzwerk (standardmäßig Port 8080). |
| Name | string | Nein | Name des Geräts in Gladys. Leer: „Orange TV“ gefolgt von der Adresse. |
| Optionen | section | Nein | |
| Leseintervall | select | Nein | Wie oft die Decoder gelesen werden: die Verzögerung der Sender- und Statusänderungen. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen und der Texte der Integration (Sender, Szenenmeldungen). |
So installierst du Orange TV in Gladys
- Öffne in Gladys Integrationen: Orange TV erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-orange-tv:1.0.0) 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-orange-tv.
Orange TV 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
Orange TV 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