Skip to content

Samsung Smart TV app for Athom Homey

License

Notifications You must be signed in to change notification settings

balmli/com.samsung.smart

Repository files navigation

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
  • 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)
  • 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.

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.

Acknowledgements:

Thanks to https://github.com/natalan/samsung-remote for solution to support older Samsung TVs.

Thanks to https://github.com/tavicu/homebridge-samsung-tizen for solution to pair with newer Samsung TVs.

Thanks to https://github.com/tdudek/samsung-remote-models-2014-and-newer and https://github.com/kkapitan/homebridge-homesung for solution to pair with H, HU, J, JU and JS models.

Feedback:

Please report issues at the issues section on Github.

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:

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