VIZIO SmartCast Smart-Home-Integration, kostenlos und Open Source
VIZIO-SmartCast-Fernseher und -Soundbars lokal: Ein/Aus, Lautstärke, Eingänge, Apps, Tasten.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Steuere deine VIZIO-SmartCast-Fernseher und -Soundbars mit Gladys, in deinem lokalen Netzwerk: Ein/Aus, Lautstärke, Stummschaltung, Eingänge, Apps, Bild- und Klangmodi, Fernbedienungstasten. Keine Cloud, kein VIZIO-Konto: Gladys spricht direkt mit der SmartCast-API jedes Geräts (der API, die auch die VIZIO-App verwendet).
Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Diese Integration wurde nach dem dokumentierten Protokoll und echten Antworten von VIZIO-Fernsehern geschrieben, die Open-Source-Projekte veröffentlicht haben, und bisher an keinem echten Fernseher getestet. Sag uns, was funktioniert und was nicht: github.com/guim31/gladys-vizio/issues.
Diese Integration steht in keiner Verbindung zu VIZIO, Inc. VIZIO und SmartCast sind Marken ihrer jeweiligen Inhaber.
Voraussetzungen
- Ein VIZIO-SmartCast-Fernseher (ab 2016) oder eine Soundbar, im selben lokalen Netzwerk wie Gladys.
- Gladys Assistant 5.1.0 oder neuer.
- Stelle am Fernseher den Energiemodus auf Schnellstart („Quick Start“; Menü, System, Energiemodus). Im Eco-Modus schaltet ein Fernseher im Standby sein Netzwerk ab: Gladys sieht ihn nicht mehr und kann ihn nicht einschalten, bis er mit seiner Fernbedienung eingeschaltet wird. Die Integration nutzt kein Wake-on-LAN: VIZIO dokumentiert es nicht, und kein Bericht zeigt, dass es einen Fernseher im Eco-Modus weckt.
- Gib jedem Gerät eine feste IP-Adresse in deinem Router (empfohlen).
Installation und Konfiguration
- Öffne in Gladys Integrationen, dann Von GitHub installieren, und installiere
guim31/gladys-vizio. - Schalte deine Fernseher und Soundbars ein. Die Integration sucht sie im Netzwerk (mDNS, über Gladys) beim Start und bei jeder Suche im Tab Erkennung.
- Ein Gerät, das nicht gefunden wird (anderes Netzwerk, mDNS blockiert): Gib seine IP-Adresse
unter Adressen (optional) ein, mehrere durch Kommas getrennt (
192.168.1.30, 192.168.1.31). - Soundbars brauchen keine Kopplung und erscheinen sofort im Tab Erkennung. Fernseher müssen zuerst gekoppelt werden (unten).
- Füge die Geräte im Tab Erkennung zu Gladys hinzu.
Optionen:
- Lieblings-Apps: die Apps der Liste App jedes Fernsehers und standardmäßig des
Verknüpfungs-Widgets, mit ihrem SmartCast-Namen (standardmäßig
Netflix, YouTube, Prime Video, Disney+, Hulu, Apple TV+, höchstens 12). Die Namen sind die des SmartCast-Katalogs von pyvizio (150 Apps: Netflix, Prime Video, Disney+, Hulu, YouTube, YouTube TV, Max als „HBO Max“, Peacock, Paramount+, Plex, Pluto TV, Tubi, Apple TV+…); ein Name, der nicht im Katalog steht, wird im Status der Integration gemeldet. - Aktualisierungsintervall: 10, 15 oder 30 Sekunden.
- Lautstärkeschritt: Änderung pro Druck auf Lauter und Leiser.
- Sprache der Funktionsnamen: die Namen der Funktionen beim Hinzufügen eines Geräts (sie bleiben danach, wie sie sind), sowie die Texte der Listen und Szenenereignisse. Standardmäßig Französisch.
Einen Fernseher koppeln
Ein Fernseher gehorcht nur einem Client, den er kennt: Er zeigt eine PIN und gibt ein Token, sobald
die PIN eingegeben ist. Die Integration bewahrt das Token in ihrem privaten Speicher (/data) auf,
nie in den Protokollen.
- Schalte den Fernseher ein.
- Starte in der Konfiguration der Integration Kopplung starten. Der Fernseher zeigt eine 4-stellige PIN. Warten mehrere Fernseher auf die Kopplung, gib die Adresse des zu koppelnden im Feld der Aktion ein.
- Gib die PIN im Feld von PIN eingeben ein und starte die Aktion, innerhalb von 5 Minuten.
- Der Fernseher erscheint im Tab Erkennung: Füge ihn hinzu.
Der Fernseher führt Gladys dann unter seinen gekoppelten Geräten (unter dem Namen „Gladys“). Eine falsche PIN kann erneut eingegeben werden, solange der Fernseher sie zeigt. Eine neue Kopplung ersetzt das Token. Nach einem Zurücksetzen des Fernsehers koppelst du ihn erneut.
Verbindung testen sucht die Geräte, liest jedes davon und meldet für jedes, was es findet: Modell, eingeschaltet oder im Standby, Eco-Modus, Kopplung nötig, eine Adresse ohne Antwort.
Geräte und Funktionen
Ein Gerät pro Fernseher oder Soundbar, erkannt an seiner Seriennummer: Ein Wechsel der IP-Adresse (DHCP) wird verfolgt, das Gerät bleibt dasselbe.
Fernseher
| Funktion | Was sie tut |
|---|---|
| Ein / Aus | Ein oder Standby; schaltet den Fernseher ein oder aus (zum Einschalten ist Schnellstart nötig). |
| Lautstärke | 0 bis 100, wie am Fernseher. |
| Lautstärke niedriger / höher | Tasten, um den Lautstärkeschritt der Konfiguration. |
| Stumm | Taste: schaltet stumm oder wieder laut (der Zustand steht im Widget und in Aktuelle Wiedergabe). |
| Eingang | Liste der Eingänge des Fernsehers, mit den am Fernseher gesetzten Namen (SmartCast, HDMI-1, PS5…). |
| App | SmartCast-Startseite, die Lieblings-Apps und „Andere“ (ein Eingang oder eine App außerhalb der Liste). |
| Aktuelle Wiedergabe | Text: die App (Netflix…), der Eingang oder Aus. |
| Bildmodus | Liste der Bildmodi des Fernsehers (Vivid, Calibrated, Game…), wenn er welche hat. |
| Voriger Kanal / Nächster Kanal | Tasten, bei Fernsehern mit Tuner. |
Soundbar
Ein / Aus, Lautstärke (0 bis 31 bei den meisten Soundbars, vom Gerät gelesen), Lautstärke niedriger, Lautstärke höher, Stumm, Eingang (HDMI, Bluetooth, optisch…), Aktuelle Wiedergabe (der Eingang) und Klangmodus (der Equalizer der Soundbar: Music, Movie…), wenn sie einen hat.
Die Funktionsnamen folgen der Option Sprache der Funktionsnamen: Ein / Aus, Lautstärke, Lautstärke niedriger, Lautstärke höher, Stumm, Eingang, App, Aktuelle Wiedergabe, Bildmodus, Klangmodus, Voriger Kanal, Nächster Kanal.
Dashboard-Widgets
- VIZIO-Fernbedienung: Zustand des Geräts, was läuft, Lautstärke, und die Tasten Ein/Aus, Leiser, Lauter und Stumm.
- VIZIO-Verknüpfungen: vier Lieblings-Apps oder -Eingänge, mit einem Tippen geöffnet; der
Fernseher schaltet sich bei Bedarf zuerst ein. Gib ihre Namen in den Widget-Einstellungen ein
(
Netflix,HDMI-1,PS5); alle leer: die Lieblings-Apps der Konfiguration (die Eingänge bei einer Soundbar). Der Eintrag im Vordergrund trägt ein Häkchen. - VIZIO-Tasten: vier Fernbedienungstasten nach Wahl (standardmäßig die Pfeile; füge ein zweites Widget für OK, Zurück, Home, Menü… hinzu). Eine Soundbar hat nur einige davon.
Jedes Widget folgt einem Gerät, das in seinen Einstellungen gewählt wird (leer: das erste).
Szenen-Auslöser
TV: App oder Eingang gewechselt löst aus, wenn etwas Neues in den Vordergrund kommt,
Einschalten inbegriffen: eine App (Netflix, YouTube…) oder ein Eingang (eine Konsole per HDMI).
Filter: das Gerät, die Art (App oder Eingang) und der Name, genau wie in der Funktion Aktuelle
Wiedergabe (Netflix, HDMI-1, PS5). Er wird innerhalb des Aktualisierungsintervalls erkannt.
Variablen: der Gerätename, die Art (app oder input) und der Name.
Ein- und Ausschalten brauchen keinen Auslöser: Nutze den Zustand der Funktion Ein / Aus.
Szenen-Aktionen
- App auf dem Fernseher öffnen: über ihren SmartCast-Namen (
Netflix,Prime Video, auch „disney plus“ funktioniert). Schaltet den Fernseher bei Bedarf zuerst ein. Gibt den Namen der geöffneten App zurück. - Eingang wählen: über seinen Namen oder den am Fernseher gesetzten Namen (
HDMI-1,PS5). Schaltet das Gerät bei Bedarf zuerst ein. - Fernbedienungstaste senden: Pfeile, OK, Zurück, Home, Menü, Info, Abspielen, Pause, Zurückspulen, Vorspulen, Lautstärke, Stumm, Kanal, Letzter Kanal, Nächster Eingang; bis zu 10-mal wiederholt.
Szenenbeispiele
- Filmabend: Auslöser TV: App oder Eingang gewechselt, Art App, Name
Netflix→ das Licht im Wohnzimmer auf 20 % dimmen und die Rollläden schließen. - Konsolenzeit: Auslöser TV: App oder Eingang gewechselt, Art Eingang, Name
PS5→ den Bildmodus auf Game stellen (Funktion Bildmodus) und das Ambientelicht einschalten. - Gute Nacht: um 23:30 Uhr, wenn Ein / Aus des Fernsehers an ist → eine Benachrichtigung senden und den Fernseher 15 Minuten später ausschalten.
- Morgennachrichten: werktags um 7 Uhr → App auf dem Fernseher öffnen
YouTube TV, dann die Lautstärke auf 15 stellen.
Aktualisierung und Netzwerk
Die Integration liest jedes Gerät mit ihrem eigenen Timer im gewählten Intervall: eine Anfrage für den Zustand eines Fernsehers im Standby; eingeschaltet zwei bis vier Anfragen (Ein/Aus, Eingang und App, Toneinstellungen, Bildmodus). Ein Gerät ohne Antwort (Eco-Modus) kostet einen Verbindungsversuch pro Intervall und wird nicht als Fehler gemeldet. Die Zustände werden nur bei einer Änderung an Gladys gesendet, und erneut alle 6 Stunden. Die Eingänge werden alle 30 Minuten neu gelesen, die Grenzen und Listen der Einstellungen einmal am Tag.
Die SmartCast-API ist lokal, ohne Kontingent; ihr Server ist klein, deshalb sendet die Integration jedem Gerät nur eine Anfrage auf einmal. Alles bleibt in deinem Netzwerk: HTTPS auf Port 7345 oder 9000, mit dem selbstsignierten Zertifikat des Geräts.
Fehlerbehebung
- Kein Gerät gefunden: Das Gerät muss eingeschaltet sein (oder im Schnellstart-Standby) und im selben Netzwerk wie Gladys. Sonst gib seine Adresse unter Adressen (optional) ein und starte Verbindung testen.
- „Kopplung nötig“ im Status der Integration: Starte Kopplung starten bei eingeschaltetem Fernseher.
- „Der Fernseher akzeptiert Gladys nicht mehr“: Der Fernseher hat das Token vergessen (Zurücksetzen, Firmware-Update): Kopple ihn erneut.
- Der Fernseher lässt sich von Gladys nicht einschalten: Er ist im Eco-Modus; wähle am Fernseher Schnellstart.
- Falsche PIN: Gib die angezeigte PIN erneut ein oder starte Kopplung starten noch einmal für eine neue. Nach zu vielen Versuchen lehnt der Fernseher die Kopplung eine Weile ab.
- Eine App öffnet sich nicht oder erscheint als „Unbekannte App“: Die App steht nicht im SmartCast-Katalog, oder ihre Kennung hat sich geändert. Nenne uns ihren Namen in einem Issue.
- Ausführliche Protokolle: Starte den Container mit
LOG_LEVEL=debug.
Einschränkungen
- Ohne die Hardware entwickelt: Die Anfragen folgen pyvizio und vizaio sowie den von ihnen veröffentlichten Mitschnitten eines echten Fernsehers, aber diese Integration lief noch nie an einem echten VIZIO-Gerät.
- Ein Fernseher im Eco-Modus kann während des Standbys weder gesehen noch eingeschaltet werden.
- Die App-Liste ist der SmartCast-Katalog von pyvizio: Ein Fernseher hat keine Anfrage, die seine installierten Apps auflistet.
- Der Stumm-Zustand wird angezeigt, aber Stumm ist eine Umschalttaste (SmartCast-Fernseher behandeln jede Stumm-Taste als Umschalter).
- Bildmodus und Klangmodus hängen von der Firmware ab und erscheinen nur, wenn das Gerät sie anbietet.
- VIZIO verkauft SmartCast-Geräte nur in Nordamerika.
Konfigurationseinstellungen
Diese Einstellungen fragt VIZIO SmartCast in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine VIZIO-Geräte | section | Nein | SmartCast-Fernseher und -Soundbars werden in deinem Netzwerk gefunden. Kopple jeden Fernseher einmal mit den beiden Aktionen unten. Stelle den Energiemodus des Fernsehers auf Schnellstart: Im Eco-Modus kann Gladys ihn nicht einschalten. |
| Adressen (optional) | string | Nein | Nur für ein Gerät, das die Suche nicht findet: seine IP-Adresse, durch Kommas getrennt. Lege sie in deinem Router fest. |
| Lieblings-Apps | string | Nein | Die Apps der App-Liste jedes Fernsehers und des Verknüpfungs-Widgets, mit ihrem SmartCast-Namen, durch Kommas getrennt (höchstens 12). |
| Optionen | section | Nein | |
| Aktualisierungsintervall | select | Nein | Wie oft die Geräte gelesen werden. Ein Gerät im Eco-Modus wird nicht gelesen. |
| Lautstärkeschritt | select | Nein | Änderung pro Druck auf Lauter und Leiser. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen beim Hinzufügen eines Geräts sowie Texte der Listen und Szenenereignisse. |
So installierst du VIZIO SmartCast in Gladys
- Öffne in Gladys Integrationen: VIZIO SmartCast erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-vizio: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-vizio.
VIZIO SmartCast 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
VIZIO SmartCast 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