The Samsung Smart TV integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control a Samsung Smart TV.

Configuration

To add the Samsung Smart TV device to your Home Assistant instance, use this My button:

👁 Image

Samsung Smart TV can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Supported devices

The following Samsung TV models are known to be supported by the integration:

• Samsung Smart TVs with Tizen operating system (2016 and later)
• Samsung TVs with WebSocket API support
• Samsung TV models with both REST API and WebSocket capabilities

For specific model compatibility, check your TV’s specifications to ensure it has a smart platform and network connectivity.

Supported functionality

The Samsung Smart TV integration provides the following entities and functionality:

Media player

• Power control: Turn the TV on and off
• Volume control: Adjust volume and mute/unmute
• Channel selection: Change channels directly by number
• Source selection: Switch between TV, HDMI inputs, and applications
• Playback control: Play, pause, stop, and fast forward media
• Media information: Display current channel, source, and playback metadata

Remote

• Key commands: Send remote control commands to your TV using standard key codes
• Command sequences: Execute multiple commands in sequence
• Extended key support: Navigation, menu control, and specialized functions

Diagnostics

• Device diagnostics: Troubleshooting information for device connectivity and status

List of triggers

The Samsung Smart TV integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following triggers. Each link below opens a dedicated page with examples, fields, and a step-by-step UI walkthrough.

• Device is requested to turn on (samsungtv.turn_on) Triggers when a Samsung TV device is requested to turn on.

For an overview of every trigger across all integrations, see the triggers reference.

Data updates

The SamsungTV integration uses a local REST API with a WebSocket notification channel for immediate state information for media metadata, playback progress, volume level, and other state information. For older TV models that still use the legacy bridge implementation (internally called SamsungTvBridge), the integration polls the TV every 10 seconds to retrieve the latest state information.

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

automation:
 - alias: "TurnOnLivingRoomTVwithWakeOnLan"
 triggers:
 - trigger: samsungtv.turn_on
 entity_id: media_player.samsung_smart_tv
 actions:
 - action: wake_on_lan.send_magic_packet
 data:
 mac: aa:bb:cc:dd:ee:ff

Any other actions to power on the device can be configured.

Usage

Changing channels

Changing channels can be done by calling the media_player.play_media action 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.

Remote

The integration supports the remote platform. The remote allows you to send key commands to your TV with the remote.send_command action. The supported keys vary between TV models.

Example to send sequence of commands:

action: remote.send_command
target:
 device_id: 72953f9b4c9863e28ddd52c87dcebe05
data:
 command:
 - KEY_MENU
 - KEY_RIGHT
 - KEY_UP
 - KEY_UP
 - KEY_ENTER

Known limitations

Subnet/VLAN restrictions

Samsung Smart TVs do not allow WebSocket connections across different subnets or VLANs. If your TV is not on the same subnet as Home Assistant, the integration will fail to establish a connection. 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 is automatically detected when attempting to send commands using the WebSocket connection, and will trigger the corresponding authentication flow.

Troubleshooting

Samsung TV keeps asking for permission

The default setting on newer televisions is to ask for permission on every connection attempt.

Resolution

1. On your TV, navigate to Device connection manager > Access notification.
2. Change the setting to First time only.
3. In Device connection manager > Device list, clean up any previous connection attempts from Home Assistant.

After making these changes, the TV should no longer ask for permission on each connection.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.