Remote control Samsung televisions via TCP/IP connection
Project description
Forked from Ape/samsungctl github for use with legacy series TV.
In my case a F series (2013) Samsung TV. Added extra time for time_interval to process string of key codes
samsungTVlegacy
samsungTVlegacy is a library and a command line tool for remote controlling Samsung televisions via a TCP/IP connection. It currently supports both pre-2016 TVs as well most of the modern Tizen-OS TVs with Ethernet or Wi-Fi connectivity.
Dependencies
Python 3
websocket-client (optional, for 2016+ TVs)
curses (optional, for the interactive mode)
Installation
samsungTVlegacy can be installed using pip <(https://pip.pypa.io/>:
# pip install samsungTVlegacy
Alternatively you can clone the Git repository and run:
# python setup.py install
It’s possible to use the command line tool without installation:
$ python -m samsungTVlegacy
Command line usage
You can use samsungTVlegacy command to send keys to a TV:
$ samsungTVlegacy --host <host> [options] <key> [key ...]
host is the hostname or IP address of the TV. key is a key code, e.g. KEY_VOLDOWN. See Key codes.
There is also an interactive mode (ncurses) for sending the key presses, to check what key codes are available for your TV:
$ samsungTVlegacy --host <host> [options] --interactive
Use samsungTVlegacy --help for more information about the command line arguments:
usage: samsungTVlegacy [-h] [--version] [-v] [-q] [-i] [--host HOST] [--port PORT] [--method METHOD] [--name NAME] [--description DESC] [--id ID] [--timeout TIMEOUT] [key [key ...]] Remote control Samsung televisions via TCP/IP connection positional arguments: key keys to be sent (e.g. KEY_VOLDOWN) or set of keys (e.g. KEY_SOURCE KEY_RIGHT KEY_ENTER) optional arguments: -h, --help show this help message and exit --version show program's version number and exit -v, --verbose increase output verbosity -q, --quiet suppress non-fatal output -i, --interactive interactive control --host HOST TV hostname or IP address --port PORT TV port number (TCP) --method METHOD Connection method (legacy or websocket) --name NAME remote control name --description DESC remote control description --id ID remote control id --timeout TIMEOUT socket timeout in seconds (0 = no timeout) E.g. samsungTVlegacy --host 192.168.0.10 --name myremote KEY_VOLDOWN
The settings can be loaded from a configuration file. The file is searched from $XDG_CONFIG_HOME/samsungctl_legacy.conf, ~/.config/samsungctl_legacy.conf, and /etc/samsungctl_legacy.conf in this order. A simple default configuration is bundled with the source as samsungctl_legacy.conf.
Library usage
samsungTVlegacy can be imported as a Python 3 library:
import samsungTVlegacy
A context managed remote controller object of class Remote can be constructed using the with statement:
with samsungTVlegacy.Remote(config) as remote:
# Use the remote object
The constructor takes a configuration dictionary as a parameter. All configuration items must be specified.
Key |
Type |
Description |
---|---|---|
host |
string |
Hostname or IP address of the TV. |
port |
int |
TCP port number. (Default: 55000) |
method |
string |
Connection method (legacy or websocket) |
name |
string |
Name of the remote controller. |
description |
string |
Remote controller description. |
id |
string |
Additional remote controller ID. |
timeout |
int |
Timeout in seconds. 0 means no timeout. |
The Remote object is very simple and you only need the control(key) method. The only parameter is a string naming the key to be sent (e.g. KEY_VOLDOWN). See Key codes. You can call control multiple times using the same Remote object. The connection is automatically closed when exiting the with statement.
When something goes wrong you will receive an exception:
Exception |
Description |
---|---|
AccessDenied |
The TV does not allow you to send keys. |
ConnectionClosed |
The connection was closed. |
UnhandledResponse |
An unexpected response was received. |
socket.timeout |
The connection timed out. |
Example program
This simple program opens and closes the menu a few times.
#!/usr/bin/env python3
import samsungTVlegacy
import time
config = {
"name": "samsungTVlegacy",
"description": "PC",
"id": "",
"host": "192.168.0.10",
"port": 55000,
"method": "legacy",
"timeout": 0,
}
with samsungTVlegacy.Remote(config) as remote:
for i in range(10):
remote.control("KEY_MENU")
time.sleep(0.5)
Key codes
The list of accepted keys may vary depending on the TV model, but the following list has some common key codes and their descriptions.
The Samsung Series F TV has a limited number of key codes as listed below.
Key code |
Description |
---|---|
KEY_POWEROFF |
Power off |
KEY_UP |
Up |
KEY_DOWN |
Down |
KEY_LEFT |
Left |
KEY_RIGHT |
Right |
KEY_CHUP |
P Up |
KEY_CHDOWN |
P Down |
KEY_ENTER |
Enter |
KEY_RETURN |
Return |
KEY_CH_LIST |
Channel List |
KEY_MENU |
Menu |
KEY_SOURCE |
Source |
KEY_GUIDE |
Guide |
KEY_TOOLS |
Tools |
KEY_INFO |
Info |
KEY_RED |
A / Red |
KEY_GREEN |
B / Green |
KEY_YELLOW |
C / Yellow |
KEY_BLUE |
D / Blue |
KEY_PANNEL_CHDOWN |
3D |
KEY_VOLUP |
Volume Up |
KEY_VOLDOWN |
Volume Down |
KEY_MUTE |
Mute |
KEY_0 |
0 |
KEY_1 |
1 |
KEY_2 |
2 |
KEY_3 |
3 |
KEY_4 |
4 |
KEY_5 |
5 |
KEY_6 |
6 |
KEY_7 |
7 |
KEY_8 |
8 |
KEY_9 |
9 |
KEY_TV |
TV Source |
KEY_HDMI |
HDMI Source |
Please note that some codes are different on the 2016+ TVs. For example, KEY_POWEROFF is KEY_POWER on the newer TVs.
References
I did not reverse engineer the control protocol myself and samsungctl is not the only implementation. Here is the list of things that inspired samsungctl.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for samsungTVlegacy-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ed4de2343f873ef85bce0db2f25f586004c78b042441f00a336056f5132e4b31 |
|
MD5 | 725f7eb6160fc62967e901d9c142087f |
|
BLAKE2b-256 | af8df610d1f7813153d6b3c1e2683f201e2c4d6ef57172dfedc85ddfa1fd86d3 |