Check for support
Samsung
You can check if your TV is supported by accessing the following link, with the IP address for your TV:
http://"TV IP address":8001/api/v2/
You should get a response with information about your TV.
Samsung (encrypted)
For H, HU, J, JU and JS models, that respond to
http://"TV IP address":8001/ms/1.0/
Samsung (legacy)
Older Samsung TVs before 2014 might also work. See the “Samsung (legacy)” device.
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 2016+ TVs, that respond to http://TV-IP-ADDRESS:8001/api/v2/
It is possible to select ‘Secure connection’ in ‘Advanced settings’ if the authorization with the TV failed for some reason. ‘Secure connection’ is only necessary for newer (2018+) models.
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 input source (requires that the SmartThings API is enabled in Adv. settings)
- Set power state
Device: Samsung (encrypted)
For H, HU, J, JU and JS models, from 2014 and 2015, 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 before 2014, 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
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: // Big Buck Bunny 60fps 4K - Official Blender Foundation Short Film - YouTube
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 SmartThings. Add a little smartness to your things. 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 on this community page.
Acknowledgements:
Thanks to GitHub - natalan/samsung-remote: Module for integration of Samsung SmartTV with your NodeJS application for solution to support older Samsung TVs.
Thanks to GitHub - tavicu/homebridge-samsung-tizen: Homebridge plugin for Samsung TV's with Tizen OS for solution to pair with newer Samsung TVs.
Thanks to GitHub - tdudek/samsung-remote-models-2014-and-newer and GitHub - kkapitan/homebridge-homesung: A Homebridge plugin for Samsung SmartTV H and J models with the pairing protocol for solution to pair with H, HU, J, JU and JS models.
Disclaimer
Use at your own risk. I accept no responsibility for any damages caused by using this app.
Release Notes:
2.1.0
- Added action to close running app
- Improvements to SmartThings API
2.0.1
- Updated pairing
1.9.3
- Bugfix for pairing
1.9.2
- Bugfix for SDK3
1.9.1
- 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.