Home Assistant Home Assistant
Edit this page on GitHub

Samsung Smart TV

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

Setup

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

Configuration

To add a TV to your installation without relying on the discovery component, add the following to your configuration.yaml file:

# Example configuration.yaml entry
media_player:
  - platform: samsungtv
    host: IP_ADDRESS

Configuration Variables

host

(string)(Required)

The IP of the Samsung Smart TV, e.g., 192.168.0.10.

port

(integer)(Optional)

The port of the Samsung Smart TV. If set to 8001, the new websocket connection will be used (required for 2016+ TVs) - for installs other than Hass.io or Docker you may need to install a Python package, see below.

Default value:

55000

name

(string)(Optional)

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

timeout

(time)(Optional)

The timeout for communication with the TV in seconds.

Default value:

0 (no timeout)

mac

(string)(Optional)

The MAC address of the Samsung Smart TV, e.g., 00:11:22:33:44:55:66. Required for power on support via wake on lan.

broadcast_address

(string)(Optional)

The broadcast address on which to send the Wake-On-Lan packet.

Default value:

255.255.255.255

Supported models

If your model is not on the list then give it a test, if everything works correctly then add it to the list on GitHub.

Naming

The first letter (U, P, L, H & K) represent the screen type, e.g., LED or Plasma. The second letter represents the region, E is Europe, N is North America and A is Asia & Australia. The two numbers following that represent the screen size. If you add your model remember to remove these first 4 characters before adding to the list.

For example: for model UN55NU7100, the UN55 would mean it’s an LED, North American, 55 inch TV, and the model number listed below would be the remainder: NU7100.

Models tested and working

  • C7700
  • D5500
  • D6100
  • D6300SF
  • D6500
  • D6505
  • D6900 (WOL did not work)
  • D7000
  • D8000
  • EH5300
  • EH5600
  • ES5500
  • ES5700
  • ES6100
  • ES6300
  • ES6800
  • F4580
  • F6300
  • F6400
  • F6400AF
  • F6500
  • F7000
  • F8000BF
  • K5579 (port must be set to 8001, On/Off, Forward/Backward, Volume control, but no Play button)
  • K5600AK (partially supported, turn on works but state is not updated)
  • K6500AF (port must be set to 8001)
  • KS7005 (port must be set to 8001, MAC address must be provided, On/Off, Volume are OK, no channel change)
  • KS7502 (port must be set to 8001, turn on doesn’t work, turn off works fine)
  • KS8000 (port must be set to 8001)
  • KS8005 (port must be set to 8001)
  • KS8500 (port must be set to 8001)
  • KU6020 (port must be set to 8001)
  • KU6100 (port must be set to 8001)
  • KU6290 (port must be set to 8001)
  • KU6400U (port must be set to 8001)
  • KU7000 (port must be set to 8001)
  • M5620 (port must be set to 8001)
  • MU6170UXZG (port must be set to 8001)
  • NU7090 (port must be set to 8801, On/Off, MAC must be specified for Power On)
  • NU7400 (port set to 8001)
  • NU8000
  • U6000 (port must be set to 8001)
  • U6300 (port must be set to 8001)
  • UE6199UXZG (port must be set to 8001, On/Off, Forward/Backward, Volume control, but no Play button)
  • UE65KS8005 (port must be set to 8001, On/Off, Forward/Backward, Volume are OK, but no Play button)
  • UE49KU6470 (port must be set to 8001, On/Off, Forward/Backward, Volume are OK, but no Play button)
  • UE46ES5500 (partially supported, turn on doesn’t work)

Models tested but not yet working

  • J5200 - Unable to see state and unable to control
  • J5500 - State is always “on” and unable to control (but port 8001 is open)
  • J6200 - State is always “on” and unable to control (but port 8001 is open)
  • J6300 - State is always “on” and unable to control (but port 8001 is open)
  • JS8005 - State tracking working but unable to control (but port 8001 is open)
  • JS9000 - State is always “on” and unable to control (but port 8001 is open)
  • JS9500 - State is always “on” and unable to control (but port 8001 is open)
  • JU6445K - State is always “on” and unable to control (but port 8001 is open)
  • JU6800 - Unable to see state and unable to control
  • JU7000 - Unable to see state and unable to control (but port 8001 is open)
  • JU7500 - Unable to see state and unable to control
  • MU6125 - Unable to see state and unable to control (Tested on UE58MU6125 on port 8001 and 8801)
  • MU6300 - Port set to 8001, turning on works, status not working reliably, turning off is not permanent (it comes back on)
  • MU6400 - Unable to see state and unable to control (using latest 1270 firmware. Had limited functionality on previous firmware)
  • Q60 – Turning on works, turning off does not work, State is always “off”.
  • Q6F – Port set to 8001, turning on works, turning off does not work, status not working reliably.
  • Q7F - State is always “off” and unable to control via port 8001.
  • Q9F - Turning on works, turning off does not work. State is correct. Nothing else works. Port 8001.

None of the 2014 (H) and 2015 (J) model series (e.g., J5200) will work, since Samsung have used a different (encrypted) type of interface for these.

Usage

Changing channels

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

{
  "entity_id": "media_player.office_tv",
  "media_content_id": "590",
  "media_content_type": "channel"
}

Selecting a source

Source selection is not yet implemented.

Hass.io

No additional actions are required

Docker

No additional actions are required

Other install methods

You will need to install the websocket-client Python package in your Home Assistant install. This will probably be done with:

pip3 install websocket-client

Remembering to activate your venv if you’re using a venv install.