What is hisense_vidaa?

stevene1919/hisense_vidaa — explained in plain English

Analysis updated 2026-05-18

★ 1PythonAudience · generalComplexity · 2/5Setup · moderate

Mindmap

mindmap
  root((hisense_vidaa))
    What it does
      Home Assistant integration
      Controls Hisense TV
      Direct MQTT connection
    Tech stack
      Python
      MQTT
      SSL
    Use cases
      TV power control
      Volume and input control
      Smart home automation
    Audience
      Home Assistant users
      Smart home hobbyists
    Setup
      Copy integration folder
      Add certificate and key
      Enter PIN on TV

mindmap root((hisense_vidaa)) What it does Home Assistant integration Controls Hisense TV Direct MQTT connection Tech stack Python MQTT SSL Use cases TV power control Volume and input control Smart home automation Audience Home Assistant users Smart home hobbyists Setup Copy integration folder Add certificate and key Enter PIN on TV

What do people build with it?

USE CASE 1

Control a Hisense VIDAA TV's power, volume, and input source from Home Assistant.

USE CASE 2

Add a Hisense TV as a media player entity in a smart home dashboard.

USE CASE 3

Automate turning a TV on or off as part of a home automation routine.

USE CASE 4

Pair a Hisense TV with Home Assistant using an on-screen PIN code.

What is it built with?

PythonMQTTSSL

How does it compare?

	stevene1919/hisense_vidaa	0xustaz/streamgate	a-bissell/unleash-lite
Stars	1	1	1
Language	Python	Python	Python
Setup difficulty	moderate	hard	hard
Complexity	2/5	4/5	4/5
Audience	general	developer	researcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires obtaining the TV's SSL certificate and private key before setup.

No license information was found in the project.

So what is it?

This project is a custom add-on for Home Assistant, the popular home automation platform, that lets it control a Hisense television running VIDAA OS. It connects directly to the built in messaging system on the TV itself over a secure connection, so you do not need to set up any separate messaging server or bridge on your network. This matters because many smart TV integrations rely on a third party bridge program running somewhere else on your network, and skipping that step means one less thing to install and keep running. Once installed, it lets Home Assistant turn the TV on and off, adjust and mute the volume, and switch between inputs like HDMI ports and installed apps, all shown as a single media player device inside Home Assistant. Changes on the TV are reflected back in Home Assistant right away rather than after a delay, so if someone changes the volume with the physical remote, Home Assistant's display updates to match. The connection is designed to start up even if the TV happens to be off at the time, and it automatically refreshes its access token in the background so the connection keeps working after restarts, without needing you to redo the pairing process. Setup is done through Home Assistant's normal add integration screen rather than editing configuration files by hand. You copy the integration's folder into Home Assistant, add a security certificate and key file that the TV provides, restart Home Assistant, then search for the integration and enter the TV's IP address, along with an optional MAC address. The TV displays a four digit PIN code on screen, which you type into Home Assistant to finish pairing. This PIN based flow happens automatically as part of the setup screen, so no separate pairing tool is needed. The author credits other open source contributors whose earlier reverse engineering work on how Hisense TVs communicate made this integration possible, including the original script that figured out the secure connection handshake and a related community project that decoded the newer VIDAA messaging protocol.

Copy-paste prompts

Prompt 1

Walk me through installing this Hisense VIDAA integration into my Home Assistant setup.

Prompt 2

Explain where I get the cert.pem and key.pem files this integration needs.

Prompt 3

Help me troubleshoot pairing my Hisense TV using the PIN code shown on screen.

Prompt 4

Show me how to add this TV as a media player in a Home Assistant automation.

Frequently asked questions