Zum Hauptinhalt springen

Philips TV Smart-Home-Integration, kostenlos und Open Source

Philips TV-Integration für Gladys Assistant

Philips-Fernseher (Android, Saphi): Ein/Aus, Lautstärke, Quellen, Apps, Ambilight, Tasten, lokal.

Auf GitHub ansehenAlle Integrationen

Steuere deine Philips-Fernseher aus Gladys, über dein lokales Netzwerk: ein- und ausschalten, die Lautstärke einstellen, die Quelle wechseln, eine App öffnen, den Kanal wechseln, das Ambilight einstellen (Stil, feste Farbe, ein oder aus), jede Taste der Fernbedienung drücken, vom Dashboard oder aus einer Szene. Und auf das reagieren, was auf dem Bildschirm passiert: „Wenn Netflix auf dem Fernseher startet, dimme das Licht“.

Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde mit den echten Antworten von Philips-Fernsehern gebaut und getestet, die die freie Bibliothek ha-philipsjs (die von Home Assistant) aufbewahrt, und mit der Community-Dokumentation der JointSpace-API, mit einem simulierten Fernseher, nicht mit einem echten Philips-Fernseher. Wenn etwas nicht wie beschrieben funktioniert, sag es bitte im Gladys-Forum oder in den Issues.

Was du brauchst​

  • Gladys Assistant 5.1.0 oder neuer.
  • Einen Philips-Fernseher mit der JointSpace-API 6, im selben lokalen Netzwerk wie Gladys, mit einer festen IP-Adresse (eine DHCP-Reservierung in deinem Router):
    • ein Android-TV- oder Google-TV-Modell (ab 2016): einmal mit Gladys gekoppelt, mit einem am Fernseher angezeigten Code;
    • oder ein Saphi-Modell (Linux): ohne Kopplung.
  • Um den Fernseher aus Gladys einzuschalten: am Fernseher Mit WLAN einschalten (WoWLAN) oder Mit Chromecast einschalten aktiviert (meist unter Einstellungen → Drahtlos und Netzwerke → Kabelgebunden oder WLAN). Ohne das schalten viele Fernseher im Standby ihr Netzwerk ab.

Einrichtung​

  1. Installiere die Integration aus dem Gladys-Katalog.

  2. Schalte den Fernseher ein. Klicke unter Konfiguration auf Fernseher suchen: Die Fernseher, die in deinem Netzwerk antworten, werden in die freien Plätze (Fernseher 1, 2, 3) eingetragen, mit ihrer Adresse. Oder gib die Adresse des Fernsehers selbst ein (zum Beispiel 192.168.1.20). Gib ihm bei Bedarf einen Namen und speichere.

  3. Ein Android-Fernseher wird danach einmal gekoppelt:

    1. klicke auf Kopplungscode am Fernseher anzeigen (wähle den Fernseher): Ein 4-stelliger Code erscheint auf dem Bildschirm;
    2. gib ihn bei Kopplungscode bestätigen ein (derselbe Fernseher) und starte die Aktion, zügig: Der Fernseher wartet etwa 30 Sekunden.

    Gladys erscheint am Fernseher als Gladys Assistant. Die Integration behält die Kopplung: Es wird kein Code mehr verlangt. Ein Saphi-Fernseher braucht keine Kopplung.

  4. Klicke auf Verbindung testen: Die Meldung unter der Schaltfläche zeigt für jeden Fernseher, ob er antwortet, sein Modell, ob er eingeschaltet und gekoppelt ist.

  5. Öffne den Tab Entdecken: ein Gerät pro Fernseher. Klicke auf Hinzufügen, wähle einen Raum, speichere. Ein Fernseher erscheint dort, sobald er einmal geantwortet hat: Schalte ihn ein, wenn er fehlt. Suchen in diesem Tab sucht auch nach neuen Fernsehern.

Die Optionen unten auf der Seite:

  • Wake-on-LAN (standardmäßig an): Ein Fernseher, dessen Netzwerk im Standby schläft, antwortet gar nicht mehr. Gladys bittet dann seinen Kern, ein Wake-on-LAN-Paket an die MAC-Adresse zu senden, die der Fernseher angegeben hat, und weckt ihn so. Die Integration deklariert das, wie der Installationsbildschirm zeigt.
  • Aktualisierungsintervall: wie oft die Fernseher gelesen werden (standardmäßig 10 s). Ein Fernseher im Standby wird nur nach seinem Zustand und seinem Ambilight gefragt.
  • Sprache der Funktionsnamen: die Namen der Funktionen beim Hinzufügen eines Geräts sowie die Texte der Listen und Szenenereignisse.

Das Gerät jedes Fernsehers​

FunktionWas sie tut
Ein / AusEingeschaltet oder Standby. Das Einschalten fragt den Fernseher, oder sendet ein Wake-on-LAN-Paket, wenn er gar nicht antwortet.
LautstärkeDie Lautstärke als Schieberegler, in den Grenzen des Fernsehers (0 bis 60 bei den meisten Modellen).
Lautstärke niedrigerEine Stufe leiser, wie mit der Fernbedienung.
Lautstärke höherEine Stufe lauter.
StummSchaltet den Ton stumm oder wieder ein.
QuelleAndroid-Fernseher: TV (der Tuner) oder HDMI 1 bis HDMI 4, und zum Wechseln. Andere ist eine App; sie zu wählen drückt Home.
AppAndroid-Fernseher: die App im Vordergrund (der Fernseher sagt welche), und um eine andere zu öffnen. Startbildschirm oder andere drückt Home.
KanalDie Nummer des Kanals auf dem Bildschirm, und zum Wechseln auf eine andere Nummer.
Voriger KanalVoriger Kanal.
Nächster KanalNächster Kanal.
Aktuelle WiedergabeWas auf dem Bildschirm läuft, als Text: 5 · ZDF, Netflix, HDMI 2, HDMI-Quelle oder Aus.
AmbilightAmbilight ein oder aus.
Ambilight-StilDer Stil aus den Menüs des Fernsehers: Video folgen (Standard, Lebhaft, Spiel…), Audio folgen (Lumina, Retro…), Lounge Light (Heiße Lava…) oder Feste Farbe.
Ambilight-FarbeEine feste Farbe, mit der Farbauswahl von Gladys.
Ambilight + HueDie Hue-Lampen, die dem Ambilight folgen, ein oder aus (nur Fernseher mit Ambilight + Hue).

Der Fernseher sagt, was er kann: Ein Saphi-Fernseher hat weder Quelle noch App, ein Fernseher ohne Ambilight keine Ambilight-Funktionen. Die Listen (Apps, Ambilight-Stile, Kanäle) werden vom Fernseher gelesen und von der Integration aufbewahrt, also auch da, wenn er schläft. Ein Befehl, der den Bildschirm braucht (eine Quelle, eine App, ein Kanal), schaltet den Fernseher zuerst ein und wartet bis zu 25 Sekunden auf ihn.

Dashboard​

Vier Widgets zum Nebeneinanderstellen; jedes zeigt einen Fernseher (den ersten der Konfiguration, wenn in seinen Einstellungen keiner gewählt ist). Der Kern erlaubt vier Schaltflächen pro Widget, daher vier davon.

  • Philips-Fernbedienung: der Zustand des Fernsehers, was auf dem Bildschirm läuft, die Lautstärke, und die Schaltflächen Einschalten (oder Ausschalten), Leiser, Lauter und Stumm.
  • Philips Ambilight: das Ambilight und sein Stil, eine Schaltfläche zum Ein- oder Ausschalten, und drei in den Widget-Einstellungen gewählte Stile (darunter eine feste Farbe); der aktuelle ist abgehakt.
  • Philips-Tasten: vier Tasten der Fernbedienung, in den Widget-Einstellungen gewählt: standardmäßig die Pfeile. Füge ein zweites mit OK, Zurück, Home, Quellen oder Abspielen / Pause hinzu…
  • Philips-Verknüpfungen: bis zu vier Lieblingsquellen oder -apps, in den Einstellungen über ihren Namen eingegeben (HDMI 2, Netflix…); TV und HDMI 1 bis HDMI 3, wenn nichts eingegeben ist. Ein Tippen zeigt sie an, der Fernseher wird zuerst eingeschaltet. Ein Name, den der Fernseher nicht kennt, wird unter den Schaltflächen gemeldet.

Szenen​

Auslöser​

TV: App, Kanal oder Quelle gewechselt: Der Bildschirminhalt hat sich geändert, Einschalten inbegriffen. Filter: der Fernseher, was jetzt auf dem Bildschirm läuft (App oder Startbildschirm, Kanal, HDMI-Quelle), sein Name genau wie der Fernseher ihn anzeigt (Netflix, YouTube), und wer ihn gewechselt hat (Gladys, oder der Fernseher und seine Fernbedienung, eine Konsole per HDMI-CEC…). Variablen: der Fernseher, die Art (app, channel, source), der Name (der App, des Kanals oder der Quelle), die Kanalnummer und wer gewechselt hat.

Der Fernseher sagt, welche App im Vordergrund ist: Der Wechsel von einer App zu einer anderen löst die Szene aus. Bei einer HDMI-Quelle sagt der Fernseher nicht, welche: Der Name ist der, den Gladys gewählt hat, sonst HDMI-Quelle.

Kein Auslöser „Fernseher eingeschaltet“ oder „Fernseher ausgeschaltet“: Die Funktion Ein / Aus löst Szenen bereits aus, wie jedes Gerät.

Aktionen​

  • App auf dem Fernseher öffnen: über ihren Namen wie am Fernseher (Netflix, youtube: Groß- und Kleinschreibung, Akzente und Leerzeichen spielen keine Rolle). Ausgabe: die geöffnete App.
  • Quelle des Fernsehers wählen: TV oder HDMI 1 bis HDMI 4. Ausgabe: die gewählte Quelle.
  • Ambilight einstellen: ein Stil (Video folgen · Standard, Lounge Light · Heiße Lava…), eine feste Farbe (eingegeben als #FF8800, die letzte, wenn leer) oder aus. Ein Stil, den der Fernseher nicht hat, wird abgelehnt. Ausgabe: der angewendete Stil.
  • Fernbedienungstaste senden: Home, Zurück, Pfeile, OK, Quellen, Lautstärke, Kanal, Wiedergabe, Farben, Ziffern, Ambilight…, ein- bis zehnmal. Ausgabe: die gesendeten Drücke.

Die ersten beiden brauchen einen Android-Fernseher und schalten den Fernseher bei Bedarf zuerst ein. Bei mehreren Fernsehern wähle den Fernseher in der Aktion. Die Funktionen Ein / Aus, Lautstärke, Kanal und Ambilight stehen in der üblichen Aktion Ein Gerät steuern.

Szenenideen​

  • Filmabend: freitags um 21 Uhr App auf dem Fernseher öffnen Netflix, Ambilight einstellen auf Video folgen · Immersiv, das Licht im Wohnzimmer dimmen.
  • Netflix geöffnet: Auslöser TV: App, Kanal oder Quelle gewechselt, jetzt auf dem Bildschirm App, Name Netflix: die Rollläden schließen.
  • Gute Nacht: um 23 Uhr Ambilight einstellen auf eine feste Farbe #FF6A00, dann den Fernseher (Ein / Aus) ein paar Minuten später ausschalten.
  • Haus verlassen: in der Szene „alle sind weg“ Ein / Aus der Fernseher auf Aus stellen.

Fehlerbehebung​

  • „Noch nicht erreicht: Schalte den Fernseher einmal ein“: Der Fernseher hat nie geantwortet. Prüfe seine Adresse und schalte ihn ein.
  • „Noch nicht gekoppelt“: Ein Android-Fernseher braucht die Kopplung: Kopplungscode am Fernseher anzeigen, dann Kopplungscode bestätigen.
  • „Kopplung vom Fernseher abgelehnt: Kopple ihn erneut“: Die Kopplung wurde am Fernseher gelöscht (ein Zurücksetzen, eine neue Software). Kopple ihn auf dieselbe Weise erneut.
  • „Falscher Code“: Gib die 4 angezeigten Ziffern noch einmal ein. „Der Code ist abgelaufen“: Lass einen neuen anzeigen und bestätige ihn innerhalb von 30 Sekunden.
  • „Keine Philips-TV-API unter dieser Adresse“: Dort antwortet ein anderes Gerät.
  • „Fernseher von vor 2016 (JointSpace 1)“: Diese älteren Modelle werden nicht unterstützt.
  • Der Fernseher schaltet sich nicht ein: Aktiviere am Fernseher Mit WLAN einschalten (WoWLAN) oder Mit Chromecast einschalten und lass Wake-on-LAN an; das Paket geht nicht über Router oder VLANs hinweg.
  • Fernseher suchen findet nichts: Der Fernseher muss eingeschaltet sein, im selben Netzwerk; gib stattdessen seine Adresse ein.
  • Eine HDMI-Quelle wechselt nicht: Die HDMI-Adressen sind die der Modelle ab 2019; bei älteren Android-Fernsehern nutze die Taste Quellen.
  • Die Protokolle der Integration (Tab Konfiguration) zeigen, was jeder Fernseher antwortet; ein Kopplungsschlüssel wird dort nie geschrieben.

Grenzen​

  • Ohne die Hardware entwickelt: Das Verhalten stammt aus ha-philipsjs, pylips und ihren echten Antworten, nicht von einem echten Fernseher.
  • Philips-Fernseher mit der JointSpace-API 6: Android-TV- und Google-TV-Modelle ab 2016, Saphi-Modelle. Die Modelle vor 2016 (JointSpace 1) werden nicht unterstützt.
  • Quellen und Apps: nur Android-Fernseher. Der Fernseher sagt nicht, welcher HDMI-Eingang auf dem Bildschirm ist.
  • Ambilight: die Stile aus den Menüs des Fernsehers und eine feste Farbe; die Farben pro Pixel und die Helligkeit des Ambilights werden nicht gesteuert.
  • Kanäle: die der Kanallisten des Fernsehers, einmal am Tag gelesen.
  • Alles bleibt in deinem lokalen Netzwerk: keine Cloud, kein Philips-Konto. Die Integration spricht nur mit den konfigurierten Fernsehern und bittet den Gladys-Kern um Wake-on-LAN-Pakete und SSDP-Suchen.
  • Nicht mit Philips oder TP Vision verbunden. Philips und Ambilight sind Marken der Koninklijke Philips N.V.

Konfigurationseinstellungen​

Diese Einstellungen fragt Philips TV in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Dein Philips-FernsehersectionNeinPhilips Android TV, Google TV (ab 2016) oder Saphi. Schalte den Fernseher ein, starte unten „Fernseher suchen“ oder gib seine Adresse ein und speichere. Ein Android-Fernseher wird danach einmal mit den zwei Kopplungsaktionen gekoppelt. Bis zu drei Fernseher.
AdressestringNeinIP-Adresse des Fernsehers. Lege sie in deinem Router fest.
NamestringNeinName des Geräts in Gladys. Leer: Philips und das Modell.
Zweiter Fernseher (optional)sectionNeinDieselben Felder, für einen weiteren Philips-Fernseher.
AdressestringNeinIP-Adresse des Fernsehers. Lege sie in deinem Router fest.
NamestringNeinName des Geräts in Gladys. Leer: Philips und das Modell.
Dritter Fernseher (optional)sectionNeinDieselben Felder, für einen weiteren Philips-Fernseher.
AdressestringNeinIP-Adresse des Fernsehers. Lege sie in deinem Router fest.
NamestringNeinName des Geräts in Gladys. Leer: Philips und das Modell.
OptionensectionNein
Wake-on-LANbooleanNeinWeckt einen Fernseher, dessen Netzwerk im ausgeschalteten Zustand schläft (Gladys sendet das Paket).
AktualisierungsintervallselectNeinWie oft die Fernseher gelesen werden.
Sprache der FunktionsnamenselectNeinNamen der Funktionen beim Hinzufügen eines Geräts sowie Texte der Listen und Szenenereignisse.

So installierst du Philips TV in Gladys​

  1. Öffne in Gladys Integrationen: Philips TV erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-philips-tv:1.0.3) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-philips-tv.

Philips 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​

Philips 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am