stevene1919/hisense_vidaa — explained in plain English
Analysis updated 2026-05-18
Control a Hisense VIDAA TV's power, volume, and input source from Home Assistant.
Add a Hisense TV as a media player entity in a smart home dashboard.
Automate turning a TV on or off as part of a home automation routine.
Pair a Hisense TV with Home Assistant using an on-screen PIN code.
| 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.
Requires obtaining the TV's SSL certificate and private key before setup.
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.
A Home Assistant add-on that connects directly to a Hisense VIDAA TV to control power, volume, and inputs from your smart home dashboard.
Mainly Python. The stack also includes Python, MQTT, SSL.
No license information was found in the project.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.