Samsung Smart TV

The samsungtv platform allows you to control a Samsung Smart TV.


Go to the integrations page in your configuration and click on new integration -> Samsung TV. If your TV is on and you have enabled SSDP discovery, it’s likely that you just have to confirm the detected device.

When the TV is first connected, you will need to accept Home Assistant on the TV to allow communication.

YAML Configuration

YAML configuration is around for people that prefer YAML. To use this integration, add the following to your configuration.yaml file:

# Example configuration.yaml entry
  - host: IP_ADDRESS

Configuration Variables

host string Required

The hostname or IP of the Samsung Smart TV, e.g.,

name string (Optional)

The name you would like to give to the Samsung Smart TV.

After saving the YAML configuration, the TV must be turned on before launching Home Assistant in order for the TV to be registered the first time.

Turn on action

If the integration knows the MAC address of the TV from discovery, it will attempt to wake it using wake on LAN when calling turn on. Wake on LAN must be enabled on the TV for this to work. If the TV is connected to a smart strip or requires a more complex turn-on process, a turn_on action can be provided that will take precedence over the built-in wake on LAN functionality.

You can create an automation from the user interface, from the device create a new automation and select the Device is requested to turn on automation. Automations can also be created using an automation action:

# Example configuration.yaml entry
wake_on_lan: # enables `wake_on_lan` integration

  - alias: "Turn On Living Room TV with WakeOnLan"
      - platform: samsungtv.turn_on
        entity_id: media_player.samsung_smart_tv
      - 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.


Changing channels

Changing channels can be done by calling the media_player.play_media service with the following payload:

entity_id: media_player.samsung_tv
media_content_id: 590
media_content_type: channel

Selecting a source

It’s possible to switch between the 2 sources TV and HDMI. Some older models also expose the installed applications through the WebSocket, in which case the source list is adjusted accordingly.

Known issues and restrictions


Samsung SmartTV does not allow WebSocket connections across different subnets or VLANs. If your TV is not on the same subnet as Home Assistant this will fail. It may be possible to bypass this issue by using IP masquerading or a proxy.

H and J models

Some televisions from the H and J series use an encrypted protocol and require manual pairing with the TV. This should be detected automatically when attempting to send commands using the WebSocket connection, and trigger the corresponding authentication flow.

Samsung TV keeps asking for permission

The default setting on newer televisions is to ask for permission on ever connection attempt. To avoid this behavior, please ensure that you adjust this to First time only in the Device connection manager > Access notification settings of your television. It is also recommended to cleanup the previous attempts in Device connection manager > Device list