Vidaa TV Integration for Home Assistant

Control your Hisense/Vidaa Smart TV from Home Assistant. This integration provides full control including power, volume, input sources, apps, and remote key presses.

Disclaimer: This is an independent, community-maintained project and is not affiliated with, endorsed by, or sponsored by Hisense or VIDAA. "VIDAA" and "Hisense" are trademarks of their respective owners; their use here is purely descriptive.

Features

Auto-discovery via SSDP - TVs are automatically detected on your network
PIN Pairing - Secure authentication via PIN displayed on TV
Media Player - Full media player entity with power, volume, sources, and apps
Remote - Send any remote key command
Services - Custom services for advanced control
Wake-on-LAN - Turn on TV even when in standby (if supported by your TV)

Supported TVs

This integration supports Hisense and Vidaa Smart TVs that use MQTT for remote control. This includes:

Hisense Smart TVs (2018+)
Vidaa U platform TVs
Some Toshiba TVs with Vidaa OS

Installation

HACS (Recommended)

Open HACS in Home Assistant
Click the three dots menu in the top right corner
Select "Custom repositories"
Add the repository URL: https://github.com/warrenrees/ha_vidaatv
Select "Integration" as the category
Click "Add"
Search for "Vidaa TV" in HACS and install it
Restart Home Assistant

Manual Installation

Download the latest release from GitHub
Extract the custom_components/vidaa_tv folder
Copy it to your Home Assistant's custom_components directory
Restart Home Assistant

Configuration

Automatic Discovery

Go to Settings → Devices & Services
If your TV is on the network, it should appear as a discovered device
Click Configure on the discovered TV
A PIN will appear on your TV screen
Enter the PIN in Home Assistant
Your TV is now set up!

Manual Setup

Go to Settings → Devices & Services
Click + Add Integration
Search for "Vidaa TV"
Enter your TV's IP address
A PIN will appear on your TV screen
Enter the PIN in Home Assistant
Your TV is now set up!

Entities

Media Player

The media player entity provides:

Feature	Description
Power On/Off	Turn TV on or off
Volume Up/Down	Adjust volume
Volume Set	Set specific volume level (0-100)
Mute	Toggle mute
Source Select	Switch between HDMI inputs, TV, and apps
Play/Pause/Stop	Media playback controls
Launch App	Start streaming apps

Remote

The remote entity allows sending any key command:

service: remote.send_command
target:
  entity_id: remote.living_room_tv_remote
data:
  command:
    - power
    - up
    - ok

Supported Commands

Command	Description
`power`	Toggle power
`up`, `down`, `left`, `right`	Navigation
`ok`, `select`, `enter`	Confirm selection
`back`, `return`	Go back
`home`	Home screen
`menu`	Open menu
`exit`	Exit current screen
`volume_up`, `volume_down`	Volume control
`mute`	Toggle mute
`play`, `pause`, `stop`	Playback
`fast_forward`, `rewind`	Skip forward/back
`channel_up`, `channel_down`	Channel control
`0`-`9`	Number keys
`red`, `green`, `yellow`, `blue`	Color buttons
`info`	Show info
`subtitle`	Toggle subtitles

You can also use the raw key codes (e.g., KEY_POWER, KEY_VOLUMEUP).

Services

vidaa_tv.send_key

Send a remote key press to the TV.

service: vidaa_tv.send_key
data:
  key: KEY_OK

Parameter	Type	Required	Description
`key`	string	Yes	Key code to send (e.g., `KEY_POWER`, `KEY_UP`)

vidaa_tv.launch_app

Launch an application on the TV.

service: vidaa_tv.launch_app
data:
  app: netflix

Parameter	Type	Required	Description
`app`	string	Yes	App name (netflix, youtube, amazon, disney, hulu, tubi)

Example Automations

Turn off TV at midnight

automation:
  - alias: "Turn off TV at midnight"
    trigger:
      - platform: time
        at: "00:00:00"
    action:
      - service: media_player.turn_off
        target:
          entity_id: media_player.living_room_tv

Launch Netflix when pressing a button

automation:
  - alias: "Netflix button"
    trigger:
      - platform: device
        device_id: your_remote_device
        type: button_short_press
        subtype: button_1
    action:
      - service: vidaa_tv.launch_app
        data:
          app: netflix

Volume control with a dimmer

automation:
  - alias: "TV volume from dimmer"
    trigger:
      - platform: state
        entity_id: sensor.dimmer_brightness
    action:
      - service: media_player.volume_set
        target:
          entity_id: media_player.living_room_tv
        data:
          volume_level: "{{ trigger.to_state.state | float / 100 }}"

Remote control macro

script:
  tv_navigate_to_settings:
    alias: "Navigate to TV Settings"
    sequence:
      - service: remote.send_command
        target:
          entity_id: remote.living_room_tv_remote
        data:
          command: home
      - delay: 1
      - service: remote.send_command
        target:
          entity_id: remote.living_room_tv_remote
        data:
          command:
            - right
            - right
            - right
            - ok

Lovelace Cards

Basic Media Control Card

type: media-control
entity: media_player.living_room_tv

Custom Button Card for Apps

type: horizontal-stack
cards:
  - type: button
    name: Netflix
    icon: mdi:netflix
    tap_action:
      action: call-service
      service: vidaa_tv.launch_app
      data:
        app: netflix
  - type: button
    name: YouTube
    icon: mdi:youtube
    tap_action:
      action: call-service
      service: vidaa_tv.launch_app
      data:
        app: youtube
  - type: button
    name: Prime
    icon: mdi:amazon
    tap_action:
      action: call-service
      service: vidaa_tv.launch_app
      data:
        app: amazon

Custom Remote Card

For a full remote control experience, consider using the TV Remote Card custom card:

type: custom:tv-card
entity: media_player.living_room_tv
remote: remote.living_room_tv_remote

Troubleshooting

TV not discovered

Make sure the TV is powered on (not in standby)
Ensure the TV and Home Assistant are on the same network/VLAN
Check that SSDP/UPnP is enabled on your router
Try manual setup with the TV's IP address

PIN not appearing on TV

Make sure the TV screen is on (not in screensaver mode)
Try pressing a button on the TV remote to wake it
Restart the TV and try again
Check if there's a "Remote App" or "Mobile App" setting in TV settings

Setup fails with "not authorized" (MQTT code 5)

The TV rejected the credentials. Because this happens after the TLS handshake, the certificates themselves are fine.

The usual cause is older TV firmware, which predates the credential scheme newer models use. Setup detects this and falls back automatically, but you can force it: pick Authentication mode → Static on the certificates step, or switch an existing TV over in Settings → Devices & Services → Vidaa TV → Configure. These TVs issue no auth token — they authorise Home Assistant directly once you enter the PIN.

If your TV is not on old firmware, check its date, time, timezone and DST settings: the newer credentials are time-based, and a TV whose clock disagrees with Home Assistant's rejects them.

Connection lost after reboot

The integration stores authentication tokens that should persist across reboots. If you experience issues:

Check that the TV's IP address hasn't changed (consider setting a static IP or DHCP reservation)
Remove and re-add the integration if tokens have expired

Wake-on-LAN not working

Enable Wake-on-LAN in your TV's network settings
Make sure the TV is connected via Ethernet (not WiFi) for best WoL support
Some TV models don't support WoL

Commands not working

Make sure the TV is fully booted (wait 30 seconds after power on)
Try refreshing the entity state
Check Home Assistant logs for error messages

Debug Logging

Enable debug logging for more detailed information:

logger:
  default: info
  logs:
    custom_components.vidaa_tv: debug
    pyvidaa: debug

Known Limitations

Some older Hisense TVs may not be compatible
Wake-on-LAN depends on TV model and network configuration
App IDs may vary between TV models/regions
Some TVs may disconnect after period of inactivity

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Credits

Protocol reverse-engineered from the Vidaa mobile app
Inspired by various Hisense TV integration projects

Support

GitHub Issues - Bug reports and feature requests
GitHub Discussions - General questions and community support

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
custom_components/vidaa_tv		custom_components/vidaa_tv
docs		docs
examples		examples
tests		tests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
hacs.json		hacs.json
info.md		info.md
pytest.ini		pytest.ini
requirements-test.txt		requirements-test.txt

Latest commit

History

Folders and files

Repository files navigation

Vidaa TV Integration for Home Assistant

Features

Supported TVs

Installation

HACS (Recommended)

Manual Installation

Configuration

Automatic Discovery

Manual Setup

Entities

Media Player

Remote

Supported Commands

Services

vidaa_tv.send_key

vidaa_tv.launch_app

Example Automations

Turn off TV at midnight

Launch Netflix when pressing a button

Volume control with a dimmer

Remote control macro

Lovelace Cards

Basic Media Control Card

Custom Button Card for Apps

Custom Remote Card

Troubleshooting

TV not discovered

PIN not appearing on TV

Setup fails with "not authorized" (MQTT code 5)

Connection lost after reboot

Wake-on-LAN not working

Commands not working

Debug Logging

Known Limitations

Contributing

License

Credits

Support

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages