Affiliate-Hinweis: Einige Links in diesem Artikel sind Affiliate-Links. Beim Kauf über diese Links erhalten wir eine kleine Provision — für dich ändert sich am Preis nichts.

Einen Hisense VIDAA TV in Home Assistant einzubinden scheitert bei neueren Geräten oft nicht am PIN, sondern an zwei fehlenden Client-Zertifikaten. Diese Anleitung zeigt den aktuellen Weg mit warrenrees/ha_vidaatv – vom Extrahieren der Zertifikate aus der offiziellen Android-App bis zur ersten Automation. Getestet habe ich den Ablauf mit einem Hisense 55E7NQ Pro.

Was ha_vidaatv beim Hisense VIDAA TV steuern kann

ha_vidaatv ist eine Community-Integration und nicht Bestandteil von Home Assistant Core. Sie spricht direkt mit dem MQTT-Broker im Fernseher. Bei den üblichen neueren Geräten läuft die Verbindung verschlüsselt über Port 36669 und nutzt gegenseitige TLS-Authentifizierung, kurz mTLS. Deshalb reicht die IP-Adresse allein nicht.

Unterstützt werden laut Projekt Hisense-Fernseher ab Baujahr 2018 mit VIDAA U sowie einige Toshiba-Modelle mit VIDAA. Home Assistant legt eine media_player- und eine remote-Entität an. Darüber steuerst du Power, Lautstärke, Mute, HDMI-, TV- und App-Quellen sowie Play und Pause. Wake-on-LAN hängt vom Modell ab und funktioniert über LAN meist zuverlässiger als über WLAN.

Der hier verwendete Hisense 55E7NQ Pro läuft laut Hersteller mit VIDAA Smart OS. Eine belastbare konkrete VIDAA-Generation oder Firmware-Version nennt das Datenblatt nicht. Deinen Stand findest du am TV unter Einstellungen → System → Info. Rate die Version nicht, denn Authentifizierung und Verhalten können sich je nach Firmware unterscheiden.

Voraussetzungen für die Einrichtung

Du brauchst Home Assistant, HACS, einen eingeschalteten TV im selben Netzwerk, einen Android-Rechnerverbund aus Smartphone und PC sowie ADB, unzip und OpenSSL auf dem PC. Richte für den Fernseher am besten gleich eine DHCP-Reservierung im Router ein. Eine wechselnde IP ist eine häufige Ursache für spätere Verbindungsfehler.

Die Zertifikate kommen nicht vom Fernseher. Sie stecken in der offiziellen VIDAA-Android-App aus dem Play Store. ADB greift nur auf dein Smartphone zu; ein ADB-Zugriff auf den TV ist dafür weder erforderlich noch vorgesehen.

Schritt 1: ha_vidaatv über HACS installieren

Öffne HACS und gehe über das Drei-Punkte-Menü zu Benutzerdefinierte Repositories. Trage dort diese Adresse ein:

https://github.com/warrenrees/ha_vidaatv

Wähle als Typ Integration, füge das Repository hinzu und installiere anschließend Vidaa TV. Starte Home Assistant danach neu. Falls du HACS noch nicht nutzt, solltest du es zuerst vollständig einrichten; das bloße Kopieren der URL in die normale Integrationssuche genügt nicht.

Schritt 2: APK der VIDAA-App vom Smartphone kopieren

Installiere die offizielle VIDAA-App aus dem Play Store auf deinem Android-Smartphone. Aktiviere anschließend in den Entwickleroptionen USB-Debugging, verbinde das Smartphone per USB mit dem PC und bestätige die Debugging-Abfrage auf dem Display. Androids ADB-Dokumentation erklärt die Freigabe und den Verbindungstest im Detail.

Prüfe zuerst, ob ADB das Gerät sieht:

adb devices

Der Paketname der App kann sich ändern und ist deshalb hier bewusst nicht fest eingetragen. Ermittle ihn selbst:

adb shell pm list packages | grep -i vidaa

Setze den gefundenen Namen im nächsten Befehl ein. ADB gibt daraufhin einen oder mehrere APK-Pfade aus:

adb shell pm path <gefundenes-paket>

Kopiere die Basis-APK vom ausgegebenen Pfad auf deinen PC:

adb pull <pfad>

Benenne die kopierte Datei anschließend in vidaa.apk um.

Falls mehrere Split-APKs erscheinen, beginnt die Suche mit der Basis-APK. Findest du die Datei dort nicht, ziehe auch die übrigen ausgegebenen APKs und prüfe deren Assets.

Schritt 3: vidaa_client.pem und vidaa_client.key erzeugen

Entpacke deine selbst kopierte APK in ein neues Verzeichnis:

mkdir vidaa-apk
cd vidaa-apk
unzip ../vidaa.apk
find . -name "*.p12"

Ältere App-Versionen legen den Client-Keystore als assets/client_mobile_android.p12 ab. Laut der unten verlinkten Protokollanalyse verwenden neuere VIDAA-App-Builds dagegen obfuskierte Ressourcennamen, zum Beispiel res/3R.p12. Deshalb sucht der Befehl nach allen PKCS#12-Dateien. Identifiziere darunter den Client-Keystore mithilfe der Protokollanalyse, wechsle in sein Verzeichnis und benenne ihn für die folgenden Befehle in client_mobile_android.p12 um. Wandle ihn dann mit exakt diesen Befehlen um:

openssl pkcs12 -in client_mobile_android.p12 -clcerts -nokeys -out vidaa_client.pem
openssl pkcs12 -in client_mobile_android.p12 -nocerts -nodes -out vidaa_client.key

OpenSSL fragt nach dem Keystore-Passwort. Dieses Passwort und weitere Interna dokumentiert die Datei VIDAA_PROTOCOL_ANALYSIS.md im pyvidaa-Projekt; ich drucke es hier bewusst nicht ab. pyvidaa verteilt die Client-Dateien aus rechtlichen Gründen ebenfalls nicht. Biete sie nicht weiter zum Download an, sondern extrahiere deine eigene Kopie aus der von dir installierten App. Der Eingriff erfolgt auf eigenes Risiko, und die unverschlüsselte private Schlüsseldatei gehört nicht in Backups, öffentliche Repositories oder Forenbeiträge.

Schritt 4: Zertifikate unter /config/certs ablegen

Die Integration erwartet standardmäßig certs/vidaa_client.pem und certs/vidaa_client.key relativ zum Home-Assistant-Konfigurationsverzeichnis – in Home Assistant also /config/certs/.

Home Assistant OS

Bei Home Assistant OS erreichst du /config zum Beispiel über die Studio Code Server- oder Samba share-Erweiterung. Erstelle dort den Ordner certs und kopiere beide Dateien hinein:

/config/certs/vidaa_client.pem
/config/certs/vidaa_client.key

Kontrolliere in der Terminal-Erweiterung, dass Home Assistant beide Dateien lesen kann. Sinnvolle restriktive Rechte sind:

chmod 600 /config/certs/vidaa_client.key
chmod 644 /config/certs/vidaa_client.pem

Ändere den Eigentümer nicht blind. Bei Home Assistant OS sorgen die Erweiterungen normalerweise für den passenden Zugriff innerhalb des gemeinsamen /config-Bereichs.

Home Assistant Container

Beim Container liegt /config auf dem Host dort, wohin dein Volume-Mount zeigt. Bei -v /srv/homeassistant:/config kopierst du die Dateien also nach /srv/homeassistant/certs/. Setze auf dem Host die Rechte wie oben und stelle sicher, dass UID/GID des Home-Assistant-Containers die Dateien lesen können. Entscheidend ist die Sicht im Container:

docker exec homeassistant ls -l /config/certs/

Zeigt der Befehl beide Dateien, bleiben im Einrichtungsdialog die Standardpfade korrekt.

Schritt 5: TV per PIN mit Home Assistant koppeln

Gehe zu Einstellungen → Geräte & Dienste. SSDP kann den eingeschalteten TV automatisch als Vidaa TV melden. Alternativ klickst du auf Integration hinzufügen, suchst nach Vidaa TV und gibst die feste IP-Adresse ein.

Lass SSL/TLS verwenden für einen aktuellen Fernseher eingeschaltet. Die Standardpfade sollten auf /config/certs/vidaa_client.pem und /config/certs/vidaa_client.key zeigen. Beim Auth-Modus ist auto der beste Start: Die Integration erkennt die Protokollvariante und kann zwischen static und dynamic wechseln. static ist für ältere Firmware mit transport_protocol < 3000. Bei dynamic müssen Uhrzeit, Zeitzone und Sommerzeit des Fernsehers stimmen, weil die Anmeldedaten zeitabhängig sind.

Nach dem Verbindungsaufbau zeigt der Fernseher einen PIN. Trage ihn in Home Assistant ein. Danach sollten eine Media-Player- und eine Remote-Entität erscheinen. Für ein Dashboard genügt zunächst die eingebaute Mediensteuerung; mehr Ideen findest du im Artikel zum Home-Assistant-Dashboard.

Fernbedienung und Apps aus Home Assistant starten

Mit remote.send_command schickst du benannte Kommandos oder rohe Tastencodes. Die tatsächliche Entity-ID passt du an dein Gerät an:

action: remote.send_command
target:
  entity_id: remote.hisense_tv
data:
  command:
    - KEY_POWER
    - KEY_OK

Zusätzlich bietet die Integration vidaa_tv.send_key und vidaa_tv.launch_app. Ein App-Start sieht so aus:

action: vidaa_tv.launch_app
data:
  app: netflix

Dokumentiert sind unter anderem netflix, youtube, amazon und disney. App-IDs unterscheiden sich aber nach Modell und Region. Prüfe daher die Home-Assistant-Protokolle, wenn ein Dienst auf deinem TV nicht startet.

Zwei praktische TV-Automationen

Wohnzimmerlicht beim Fernsehen dimmen

Ein TV-Status playing eignet sich als Auslöser, sofern dein Modell ihn meldet. Die aktuelle Integration bildet viele VIDAA-Aktivitäten allerdings nur als on ab und führt den Startbildschirm als Quelle Home. Prüfe deshalb zuerst unter Entwicklerwerkzeuge → Zustände, was deine Entität tatsächlich liefert, und ersetze playing bei Bedarf durch on.

alias: TV dimmt Wohnzimmerlicht
triggers:
  - trigger: state
    entity_id: media_player.hisense_tv
    to: playing
actions:
  - action: scene.turn_on
    target:
      entity_id: scene.wohnzimmer_tv
mode: restart

Für die Rückkehr vom Film zur normalen Szene kannst du auf off sowie auf den Quellenwert Home reagieren. Roh meldet VIDAA den Launcher als remote_launcher. Der Standby-Status lautet exakt fake_sleep_0; fake_sleep_1 gehört bereits zum Aufwachen und darf nicht pauschal als Schlafzustand behandelt werden.

alias: TV beendet – Wohnzimmer normal
triggers:
  - trigger: state
    entity_id: media_player.hisense_tv
    to: "off"
  - trigger: state
    entity_id: media_player.hisense_tv
    attribute: source
    to: Home
actions:
  - action: scene.turn_on
    target:
      entity_id: scene.wohnzimmer_normal
mode: restart

Mit einem Philips Hue Essential Gradient Lightstrip hinter dem Fernseher lässt sich die Szene gezielt dimmen. Für komplexere Übergänge hilft die Anleitung zur adaptiven Beleuchtung in Home Assistant.

Türklingel oder Waschmaschine hörbar machen

VIDAA stellt kein Notify-Target und kein Text-Overlay auf dem Fernseher bereit. Echte Bildschirm-Benachrichtigungen sind mit ha_vidaatv daher nicht möglich. Als realistisches Signal kannst du den TV bei einer Türklingel kurz stummschalten oder pausieren, die Lautstärke reduzieren oder auf eine andere Quelle wechseln:

alias: TV bei Türklingel pausieren
triggers:
  - trigger: state
    entity_id: binary_sensor.reolink_tuerklingel_besucher
    to: "on"
actions:
  - action: media_player.media_pause
    target:
      entity_id: media_player.hisense_tv
  - action: media_player.volume_mute
    target:
      entity_id: media_player.hisense_tv
    data:
      is_volume_muted: true
mode: single

Dasselbe Muster funktioniert mit dem Fertig-Sensor einer Waschmaschine. Für ein echtes Kamerabild auf dem TV brauchst du einen separaten Cast-fähigen Stick; Home Assistant wechselt dann dessen Quelle und sendet das Bild an den Stick, nicht an VIDAA. Die passende Klingel-Konfiguration beschreibt der Artikel zur Reolink-Türklingel in Home Assistant.

Troubleshooting: Zertifikate, not authorized und Verbindungsabbrüche

Bei Certificate files not found stimmen Pfad, Dateiname oder Leserechte nicht. Achte auf die exakte Schreibweise. Bei not authorized beziehungsweise MQTT-Code 5 war der TLS-Handshake laut Projekt bereits erfolgreich; prüfe dann zuerst Auth-Modus und TV-Uhrzeit. Erzwinge für ältere Firmware static, statt neue Zertifikate zu erzeugen.

Sehr alte Plain-MQTT-Modelle sind der Sonderfall: Schalte im Einrichtungsdialog SSL aus. Dann prüft die Integration keine Client-Zertifikate und setzt bei auto intern den statischen Auth-Modus. Das ist eine unverschlüsselte Ausnahme für ältere Fernseher, kein Ersatz für den mTLS-Weg bei aktuellen Modellen. Die alte Integration sehaas/ha_hisense_tv und Anleitungen mit Port 9223 gehören zu einem anderen, veralteten Ansatz.

Bricht die Verbindung nach längerer Inaktivität ab, prüfe zuerst die feste IP und starte den TV vollständig. Manche Geräte beantworten Anfragen erst nach dem Booten wieder. Wake-on-LAN muss am TV aktiviert sein, bleibt modellabhängig und ist über Ethernet verlässlicher.

Eine Shelly Plug PM Gen3 kann den Standby-Verbrauch messen und als manueller Hard-Power-Fallback dienen, wenn der TV gar nicht mehr antwortet. Trenne den Fernseher nicht während Updates und schalte ihn nicht regelmäßig hart aus. Warte vor dem Wiedereinschalten einige Sekunden; die Steckdose ersetzt keine saubere Standby-Steuerung. Details zur Leistungsmessung stehen in der Anleitung zum Shelly Plug S in Home Assistant.

Fazit

ha_vidaatv ist für Hisense- und Toshiba-Nutzer mit VIDAA der derzeit schlüssige lokale Weg zu Media-Player, Fernbedienung und Automationen in Home Assistant. Der aufwendige Teil ist einmalig: eigene App-APK kopieren, den PKCS#12-Keystore umwandeln und beide Dateien sauber unter /config/certs/ ablegen. Wer Text oder Kamerabilder direkt als Overlay erwartet, wird dagegen enttäuscht und braucht für Bild-Benachrichtigungen zusätzliche Cast-Hardware.

FAQ

Brauche ich ADB auf dem Hisense-Fernseher?

Nein. ADB läuft auf dem Android-Smartphone, um die installierte VIDAA-App als APK zu kopieren. Die Zertifikate stammen aus dieser App, nicht aus dem TV.

Welcher Port muss zwischen Home Assistant und TV erreichbar sein?

ha_vidaatv nutzt standardmäßig den internen MQTT-Broker des Fernsehers auf Port 36669. Aktuelle Modelle verwenden dabei in der Regel mTLS.

Warum erscheint trotz korrekter Zertifikate „not authorized“?

MQTT-Code 5 tritt nach erfolgreichem TLS-Handshake auf. Probiere bei älterer Firmware den Auth-Modus static. Bei dynamic müssen Datum, Uhrzeit, Zeitzone und Sommerzeit am TV korrekt sein.

Kann Home Assistant Nachrichten auf dem VIDAA-TV einblenden?

Nein. Die Integration hat weder ein notify-Target noch eine Text-Overlay-Funktion. Mute, Pause oder Quellenwechsel funktionieren als Signal; für Bilder brauchst du einen separaten Cast-fähigen Stick.

PJ

Philipp Just

Gründer & Autor

Schreibt über Home Assistant, ESP32 und alles was das Smart Home smarter macht.