LG webOS Smart TV

The webostv platform allows you to control a LG webOS Smart TV.

There is currently support for the following device types within Home Assistant:

To begin with enable LG Connect Apps feature in Network settings of the TV instructions.

Once basic configuration is added to your configuration.yaml file. A notification should be visible in the frontend’s Notification section. Follow the instructions and accept the pairing request on your TV.

Pairing information will be saved to a configuration file webostv.conf in the Home Assistant configuration directory. This process is IP address-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 configuration.yaml file:

# Example configuration.yaml entry

Configuration Variables

host string Required

The IP of the LG webOS Smart TV, e.g.,

name string (Optional)

The name you would like to give to the LG webOS Smart TV.

turn_on_action string (Optional)

Defines an action to turn the TV on.

customize map (Optional)

List of options to customize.

sources list (Optional)

List of hardware and webOS App inputs.

Full configuration example

A full configuration example will look like the sample below:

# Example configuration.yaml entry
  name: Living Room TV
    service: persistent_notification.create
      message: "Turn on action"
      - livetv
      - youtube
      - makotv
      - netflix



Avoid using [ ] in the name: of your device.

Using multiple TVs

It is also possible to use multiple TVs with this integration.

# Example configuration.yaml entry with multiple TVs
  - name: Living Room TV
  - name: Bedroom TV

Please note, the above provides a minimal example, however, all options are available for each individual TV.

Turn on action

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.

This usually only works if the TV is connected to the same network. Routing the WakeOnLan packet to a different subnet requires special configuration on your router or may not be possible.
# Example configuration.yaml entry
wake_on_lan: # enables `wake_on_lan` domain

  #other settings
    service: wake_on_lan.send_magic_packet
      mac: AA-BB-CC-DD-EE-FF



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, find your media_player.<name> and use the sources listed in source_list: remembering to split them per line into your sources: configuration.

Change channel through play_media service

The 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 media_content_id parameter:

  1. Channel number (i.e., ‘1’ or ‘6’)
  2. Exact channel name (i.e., ‘France 2’ or ‘CNN’)
  3. 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
  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
  entity_id: media_player.lg_webos_smart_tv
  media_content_id: "TF1"
  media_content_type: "channel"

Next/Previous buttons

The behavior of the next and previous 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

Sound output

The current sound output of the TV can be found under the state attributes. To change the sound output, the following service is available:

Service webostv.select_sound_output

Service data attribute Optional Description
entity_id no Target a specific webostv media player.
sound_output no Name of the sound output to switch to.

Generic commands and buttons

Available services: button, command

Service webostv.button

Service data attribute Optional Description
entity_id no Target a specific webostv media player.
button no Name of the button. Known possible values are LEFT, RIGHT, DOWN, UP, HOME, MENU, BACK, ENTER, DASH, INFO, ASTERISK, CC, EXIT, MUTE, RED, GREEN, BLUE, VOLUMEUP, VOLUMEDOWN, CHANNELUP, CHANNELDOWN, PLAY, PAUSE, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9

Service webostv.command

Service data attribute Optional Description
entity_id no Target a specific webostv media player.
command no Endpoint for the command, e.g., system.launcher/open. The full list of known endpoints is available at https://github.com/bendavid/aiopylgtv/blob/master/aiopylgtv/endpoints.py
payload yes An optional payload to provide to the endpoint in the format of key value pair(s).


      - service: webostv.button
          entity_id:  media_player.lg_webos_smart_tv
          button: "HOME"

      - service: webostv.command
          entity_id:  media_player.lg_webos_smart_tv
          command: "system.launcher/open"
            target: https://www.google.com


The webostv notify platform allows you to send notifications to a LG webOS Smart TV.

The icon can be overridden for individual notifications by providing a path to an alternative icon image to use:

  - alias: Front door motion
      platform: state
      entity_id: binary_sensor.front_door_motion
      to: 'on'
      service: notify.livingroom_tv
        message: "Movement detected: Front Door"
          icon: "/home/homeassistant/images/doorbell.png"


If Home Assistant and your TV are not on the same network, you need to create a firewall rule, which allows a connection on port 3000 with the TCP protocol from Home Assistant to your TV.