3.8 KiB
title, description, logo, ha_category, ha_release, ha_iot_class
| title | description | logo | ha_category | ha_release | ha_iot_class | |
|---|---|---|---|---|---|---|
| Vizio SmartCast Device | Instructions on how to integrate Vizio SmartCast TVs and sound bars into Home Assistant. | vizio-smartcast.png |
|
0.49 | Local Polling |
The vizio integration allows you to control SmartCast-compatible TVs and sound bars (2016+ models).
Find your device
Install the command line tool using pip (or download it manually):
$ pip3 install pyvizio
or
$ pip3 install git+https://github.com/vkorn/pyvizio.git@master
or
$ pip3 install -I .
Find your device using the following command:
pyvizio --ip=0 discover
and note its IP address. If using the IP address by itself does not work, you may need to append :9000 or :7345 to it when using it as a parameter in future commands.
Pairing
Before adding your device to Home Assistant, you may need to pair it manually. In particular, it is unclear how a sound bar would notify you of a valid auth token. In this case, it might be best to first skip the pairing process entirely, specify a device_class of soundbar in your configuration, and try interacting with the entity to see if you have any success. If the media player controls aren't working, and if specifying different ports as mentioned above doesn't work, you will need to find a way to obtain the auth token during this process.
To obtain an auth token, follow these steps:
Make sure that your device is on before continuing.
| Parameter | Description |
|---|---|
ip |
IP address (possibly including port) obtained from the previous section |
device_type |
The type of device you are connecting to. Options are tv or soundbar |
Enter the following command to initiate pairing:
$ pyvizio --ip={ip} --device_type={device_type} pair
Initiation will show you two different values:
| Value | Description |
|---|---|
| Challenge type | Usually it should be "1". If not, use the additional parameter --ch_type=your_type in the next step |
| Challenge token | Token required to finalize pairing in the next step |
At this point, a PIN code should be displayed at the top of your TV. With all these values, you can now finish pairing:
$ pyvizio --ip={ip} --device_type={device_type} pair-finish --token={challenge_token} --pin={pin}
You will need the authentication token returned by this command to configure Home Assistant.
Configuration
To add your Vizio TV to your installation, add the following to your configuration.yaml file:
# Example configuration.yaml entry
media_player:
- platform: vizio
host: IP_ADDRESS
access_token: AUTH_TOKEN
{% configuration %}
host:
description: IP address of your device.
required: true
type: string
access_token:
description: Authentication token you received in the last step of the pairing process (if applicable).
required: false
type: string
device_class:
description: The class of your device. Valid options are tv or soundbar
required: false
type: string
default: tv
suppress_warning:
description: Set to true to disable self-signed certificate warnings.
required: false
default: false
type: string
{% endconfiguration %}
Notes and limitations
Turning device on
If the Power Mode of your device is set to Eco Mode, turning the device on won't work.
Changing tracks
Changing tracks works like switching channels. If the current input is anything other than regular TV, this command might not do anything.
Sources
The source list shows all external devices connected to the Vizio device through HDMI, plus a list of internal devices (TV mode, Chromecast, etc.)