webostv platform allows you to control a LG webOS
To begin with enable LG Connect Apps feature in Network settings of the TV instructions.
Once basic configuration is added to your
card should prompt on your Home Assistants’s states.
Follow the instructions and accept pairing request on your TV.
Pairing information will be saved to the
filename: provided in configuration;
this process is IP sensitive,
in case the IP address of your TV would change in future.
To add a TV to your installation,
add the following to your
# Example configuration.yaml entry media_player: - platform: webostv
(string)(Optional)The IP of the LG webOS Smart TV, e.g.,
(string)(Optional)The name you would like to give to the LG webOS Smart TV.
(string)(Optional)The filename where the pairing key with the TV should be stored. This path is relative to Home Assistant’s config directory. NOTE: When using multiple TVs each TV will need its own unique file.
Default value: webostv.conf
(time)(Optional)The timeout for communication with the TV in seconds.
(string)(Optional)Defines an action to turn the TV on.
(map)(Optional)List of options to customize.
If you do not specify
host:, all LG webOS Smart TVs within your network will
A full configuration example will look like the sample below:
# Example configuration.yaml entry media_player: - platform: webostv host: 192.168.0.10 name: Living Room TV filename: webostv.conf timeout: 5 turn_on_action: service: persistent_notification.create data: message: "Turn on action" customize: sources: - livetv - youtube - makotv - netflix
[ ] in the
name: of your device.
Home Assistant is able to turn on a LG webOS Smart TV if you specify an action, like HDMI-CEC or WakeOnLan.
Common for webOS 3.0 and higher would be to use WakeOnLan feature. To use this feature your TV should be connected to your network via Ethernet rather than Wireless and you should enable LG Connect Apps feature in Network settings of the TV instructions (or Mobile App in General settings for older models) (*may vary by version).
On newer models (2017+), WakeOnLan may need to be enabled in the TV settings by going to Settings > General > Mobile TV On > Turn On Via WiFi instructions.
# Example configuration.yaml entry wake_on_lan: # enables `wake_on_lan` domain media_player: - platform: webostv host: 192.168.0.10 #other settings turn_on_action: service: wake_on_lan.send_magic_packet data: mac: "B4-E6-2A-1E-11-0F"
Any other actions to power on the device can be configured.
To obtain complete list of available sources currently configured on the TV,
once the webOS TV is configured and linked, while its powered on head to the
Developer Tools > States,
media_player.<name> and use the sources listed in
remembering to split them per line into your
play_media service can be used in a script to switch to the specified tv
channel. It selects the best matching channel according to the
- Channel number (i.e. ‘1’ or ‘6’)
- Exact channel name (i.e. ‘France 2’ or ‘CNN’)
- Substring in channel name (i.e. ‘BFM’ in ‘BFM TV’)
# Example action entry in script to switch to channel number 1 service: media_player.play_media data: entity_id: media_player.lg_webos_smart_tv media_content_id: 1 media_content_type: "channel" # Example action entry in script to switch to channel including 'TF1' in its name service: media_player.play_media data: entity_id: media_player.lg_webos_smart_tv media_content_id: "TF1" media_content_type: "channel"
The behaviour of the next and previsous buttons is different depending on the active source:
- if the source is ‘LiveTV’ (television): next/previous buttons act as channel up/down
- otherwise: next/previous buttons act as next/previous track