samsungTVlegacy 0.1.1

依赖项

• 蟒蛇 3

• websocket-client（可选，适用于 2016 年以上的电视）

• 诅咒（可选，用于交互模式）

安装

samsungTVlegacy 可以使用 pip <( https://pip.pypa.io/ >:

# pip install samsungTVlegacy

或者，您可以克隆 Git 存储库并运行：

# python setup.py install

无需安装即可使用命令行工具：

$ python -m samsungTVlegacy

命令行使用

您可以使用samsungTVlegacy命令将密钥发送到电视：

$ samsungTVlegacy --host <host> [options] <key> [key ...]

host是电视的主机名或 IP 地址。key是一个键码，例如 KEY_VOLDOWN。请参阅密钥代码。

还有一种交互模式 (ncurses) 用于发送按键，以检查您的电视可以使用哪些键码：

$ samsungTVlegacy --host <host> [options] --interactive

使用samsungTVlegacy --help获取有关命令行参数的更多信息：

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

可以从配置文件加载设置。该文件按此顺序从 $XDG_CONFIG_HOME/samsungctl_legacy.conf、~/.config/samsungctl_legacy.conf和 /etc/samsungctl_legacy.conf搜索。一个简单的默认配置作为samsungctl_legacy.conf与源捆绑在一起。

图书馆使用

samsungTVlegacy 可以作为 Python 3 库导入：

import samsungTVlegacy

可以使用with语句构造Remote类的上下文管理的远程控制器对象：

with samsungTVlegacy.Remote(config) as remote:
    # Use the remote object

构造函数将配置字典作为参数。必须指定所有配置项。

Remote对象非常简单，您只需要control (key) 方法。唯一的参数是一个字符串，命名要发送的密钥（例如 KEY_VOLDOWN）。请参阅密钥代码。您可以使用同一个Remote对象多次调用控制。退出with语句时连接会自动关闭。

当出现问题时，您将收到异常：

#!/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)

关键代码

接受的密钥列表可能因电视型号而异，但以下列表包含一些常用密钥代码及其说明。

三星 F 系列电视的按键代码数量有限，如下所示。

请注意，某些代码在 2016+ 电视上有所不同。例如， KEY_POWEROFF在较新的电视上是KEY_POWER 。

参考

我自己没有对控制协议进行逆向工程，而且 samsungctl 不是唯一的实现。这是启发 samsungctl 的事情的列表。

• http://sc0ty.pl/2012/02/samsung-tv-network-remote-control-protocol/

• https://gist.github.com/danielfaust/998441

• https://github.com/Bntdumas/SamsungIPRemote

• https://github.com/kyleaa/homebridge-samsungtv2016

• https://github.com/Ape/samsungctl