Samsung SmartTV app

Install

To install the device, the TV(s) must be turned on and on the same network as the Homey.

Searching for the TV(s) might take up to 30 seconds. If the TV is not found, the IP address can be set manually.

To be able to turn the TV on, it must support wake-on-lan / wake-on-wireless.

Device: Samsung

For newer TVs, that respond to http://TV-IP-ADDRESS:8001/api/v2/

Triggers

• TV turned on
• TV turned off
• Volume changed (requires UPnP support)

Conditions

• Is on / off
• Is app running

Actions

• Turn on
• Turn off
• Toggle on or off
• Mute the volume
• Unmute the volume
• Turn the volume up
• Turn the volume down
• Set volume to (requires UPnP support)
• One channel up
• One channel down
• Change channel
• Launch app
• Close app
• Launch video on YouTube
• Launch browser
• Send key
• Send list of keys
• Set power state

Device: Samsung (encrypted)

For H, HU, J, JU and JS models, that respond to http://TV-IP-ADDRESS:8001/ms/1.0/

Triggers

• TV turned on
• TV turned off
• Volume changed (requires UPnP support)

Conditions

• Is on / off
• Is app running (J/JU/JS-models)

Actions

• Turn on
• Turn off
• Toggle on or off
• Mute the volume
• Unmute the volume
• Turn the volume up
• Turn the volume down
• Set volume to (requires UPnP support)
• One channel up
• One channel down
• Change channel
• Launch app (J/JU/JS-models)
• Close app (J/JU/JS-models)
• Launch video on YouTube (J/JU/JS-models)
• Send key
• Send list of keys

Device: Samsung (legacy)

For older TVs, that respond to port 55000.

Triggers

• TV turned on
• TV turned off
• Volume changed (requires UPnP support)

Conditions

• Is on / off

Actions

• Turn on
• Turn off
• Toggle on or off
• Mute the volume
• Unmute the volume
• Turn the volume up
• Turn the volume down
• Set volume to (requires UPnP support)
• One channel up
• One channel down
• Change channel
• Send key
• Send list of keys

Details about actions:

Change channel

The 'Change channel' action will send a list of number-keys for the channel number, and finally the 'Enter'-key. The default delay between each key is 1250 ms, but this can be changed in 'Advanced settings'.

Example: switch to channel '123':

Will send this list of keys: 'Key 1', 'Key 2', 'Key 3', 'Enter'.

Send list of keys

With the 'Send list of keys' action it is possible to send a list of keys, with a short delay between each key. The default delay between each key is 100 ms, but this can be changed in 'Advanced settings'. If the delay is too low, the TV might not respond.

For the list of keys, see here.

To send the same key several times, add a *X after the key, where X is the number of times for the key. To add an extra delay before the next key, just add a number between 1 - 9999. The number is milliseconds.

Example: Send 'Home', 'Left' and 'Enter':

KEY_HOME,KEY_LEFT,KEY_ENTER

Example: Set the aspect ratio, increase the volume 10 times, wait 2.5 seconds (2500 ms) and then press play:

KEY_16_9,KEY_VOLUP*10,2500,KEY_PLAY

Launch video on YouTube (Samsung, Samsung Encrypted)

To use the 'Launch video on YouTube' action, the YouTube video id must be provided, which is a 11 character long string. The video id for this link on YouTube:

https://www.youtube.com/watch?v=aqz-KE-bpKQ

is aqz-KE-bpKQ

Details about Advanced settings:

IP address

The IP address of the TV.

Can be updated manually if the TV was not found or if the IP address of the TV has changed.

For the "Samsung (encrypted)" - device, it is not possible to change the IP address.

Secure connection (Samsung)

Used to enable a secure connection to the TV. Normally this is set correctly when adding the device.

To repair the secure connection, first set the "Secure connection" to 'off' and save settings, and the set it to 'on' and save settings.

Frame TV support

To be able to turn off 'The Frame', enable this.

Polling interval for TV status

Interval between each time the status of the TV (on / off) is checked, in seconds.

A value lower than 10 seconds will disable the polling.

Unexpected on/off Flow triggers

The app determines whether the TV is on from the status and network services reported by the TV. Some Samsung TVs and projectors temporarily wake their network services while the display remains off, for example during standby maintenance or SmartThings activity. Some models may also report that they are on while the screen or projector lamp is not active.

Homey can therefore briefly show the TV as on and run a "TV turned on" Flow, followed later by a "TV turned off" Flow, even though nobody visibly turned on the display. This behavior depends on the model and firmware. The app cannot reliably distinguish an active display from an awake network connection on every Samsung device. Frame TV and projector power states may also not fit a simple on/off value.

If unexpected power triggers cause unwanted actions:

• Disable Power state polling in the device's Advanced settings. Use the Set power state action from a Flow driven by a more reliable source, such as power consumption measured by a smart plug or another integration.
• Alternatively, add a delay and confirm that the TV still reports as on before operating curtains, lights, or other devices. This may filter short standby wakeups, but it is not a guarantee.

Changing only the polling interval changes how often the state is checked; it does not make the reported state more reliable.

Maximum volume level

Set the maximum volume level used for UPnP get and set volume. Default value is 30.

Delay between keys

The delay in milliseconds between each key is sent, for the 'Send list of keys' - action.

Default is 100 ms.

If the value is too low, some or all of the commands might be ignored by the TV.

Delay between channel keys

The delay in milliseconds between each key is sent, for the 'Change channel' - action.

Default is 1250 ms.

SmartThings API

To use the SmartThings API, your TV must be logged into your Samsung account.

Go to https://account.smartthings.com/tokens to generate a token with device access.

Go to advanced settings for the Samsung device, enable SmartThings API and enter the token.

This will enable the 'Set input source' - action.

Feedback:

Please report issues by visiting the communtity topic: https://community.homey.app/t/10019

Disclaimer

Use at your own risk. I accept no responsibility for any damages caused by using this app.

Some TVs use a different type of pairing, and are therefore not supported at the moment.

Release Notes:

2.2.2

• Improved power-state polling reliability for newer Samsung TVs
• Power transitions now recover cleanly from command failures, polling failures, and timeouts
• Turning off a TV that is already known to be off no longer sends a toggle power command
• Slow successful power changes no longer show Homey's 10-second timeout message
• Application-launch actions now explain authorization failures more clearly
• Added guidance for model-dependent standby wakeups and unexpected power-state Flow triggers

2.1.0

• Added action to close running app
• Improvements to SmartThings API

2.0.0

• Updated pairing

1.9.3

• Bugfix for pairing

1.9.2

• Bugfix for SDK3

1.9.1

• Bugfix for SDK3

1.9.0

• Migrated to SDK3

1.8.7

• Improvements to discover MAC address on boot (thanks to Martijn Poppen)

1.8.6

• Discover MAC address on boot (thanks to Martijn Poppen)

1.8.4

• Improvements for power state

1.8.3

• Minor bug fix
• Do not use SmartThings to check if the TV is on or off

1.8.2

• Added action to manually set the power state

1.8.1

• Fixes for power on / off

1.8.0

• Fetching volume state for TVs that support UPnP
• Fixes for 'Is app running' condition
• Fixes for 'Launch app' action

1.7.11

• Minor bug fix

1.7.10

• Minor bug fix

1.7.9

• Minor bug fix

1.7.8

• Fixed pairing bug
• Added more app IDs

1.7.7

• Minor bug fix

1.7.6

• Added app IDs for Netflix

1.7.5

• Added app ID for Apple TV

1.7.4

• Use static list of apps if fetching apps from the TV fails

1.7.3

• Fixed issue with Secure connection being reset.

1.7.2

• Uses Homey Compose

1.7.1

• Improved readme

1.7.0

• Added support for SmartThings API. Can be enabled in Advanced settings.

1.6.3

• Fix support and source url

1.6.2

• Added Ambient mode (KEY_AMBIENT) to the list of keys

1.6.1

• Added Exit (KEY_EXIT) to the list of keys

1.6.0

• Added 'Is app running' condition (Sansung encrypted)
• Added 'Launch app' action (Sansung encrypted)
• Added 'Launch video on YouTube' action (Sansung encrypted)
• Set min and max for polling interval, issue #16.

1.5.0

• Support turn off for Samsung The Frame

1.4.0

• Added 'Power on/off is in progress' condition (all devices)
• Changed the order of the volume and channel keys (all devices, need to reinstall the device for this to work)
• Added 'Polling interval for TV status (s)' in Advanced settings (all device)
• Added screen to manually set IP address (Samsung encrypted)

1.3.0

• Support for H, HU, J, JU and JS models.

1.2.0

• Faster communication with the TV by keeping the socket open for a while (Samsung)
• Action to change channel (Samsung and Samsung legacy)
• Action to send a list of keys (Samsung and Samsung legacy)

1.1.0

• Fixed 'Samsung (legacy)' device

1.0.5

• Minor bugfixes

1.0.4

• Separate device for older Samsung TVs
• Fixes for newer Samsung TVs

1.0.3

• Improved logic for on / off
• Fixes for newer Samsung TVs

1.0.2

• Added 'Launch video on YouTube' action
• Refresh list of applications every 5 minutes

1.0.1

• Autocomplete for keys

1.0.0

• Initial version