samsungtvws
Samsung Smart TV WS API wrapper
Decision gist · record as of 2026-08-14
Yes, if you own a compatible Samsung TV and need programmatic control. The library is actively maintained, has low install friction, and covers a broad range of TV models and control scenarios. The LGPL-3.0 license is permissive for most use cases but requires derivative works to remain open-source. The main gotcha is the subnet restriction—your TV must be on the same network as your client.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- TV must be on the same subnet as the client; WebSocket connections across different subnets or VLANs are not supported by Samsung TVs.
- Low install friction with a pure-Python wheel distribution.
- Active maintenance with a recent commit on 2026-08-08 and 419 repository stars.
License · maintenance · safety
LGPL-3.0 (copyleft) — Licensed under LGPL-3.0 (copyleft). Any derivative work or modification must remain open-source under the same license; proprietary applications using this library must comply with copyleft obligations.
last release 2026-05-28 (78 days) · last repo commit 2026-08-08 · 419 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 117,705 downloads/mo, #12,154 on PyPI
Alternatives
Verify before relying
pip install samsungtvws
from samsungtvws import SamsungTVWS
tv = SamsungTVWS(host="192.168.1.50")
tv.power()- Whether the library works reliably with all Tizen OS TVs from 2016 onward or if specific TV models have known compatibility issues.
- Performance characteristics when controlling multiple TVs concurrently or sending rapid command sequences.
- Whether the encrypted v1 API for older Orsay TVs (H series 2014, J series 2015) is actively maintained or deprecated.
What it is and what it does
Samsungtvws is a Python wrapper around Samsung Smart TV control APIs, letting you remotely control Tizen OS TVs (2016+) and older Orsay models via WebSocket or REST. It handles both synchronous and asynchronous control flows, with optional support for encrypted connections on legacy hardware. The library exposes remote key commands, app management, device information queries, Wake-on-LAN, and Art Mode control for Frame TVs—either programmatically from Python code or via a command-line interface.
The package depends on websocket-client, requests, and yarl for core networking, with optional extras for async I/O (aiohttp, websockets), encryption (cryptography, py3rijndael), and CLI tooling (typer, wakeonlan). It is actively maintained, marked as production-stable, and requires Python 3.9 or later. No known security vulnerabilities are recorded.
Use it for
- Automate TV power, volume, and input switching in a home automation system without a dedicated remote.
- Launch apps or open URLs on the TV programmatically from a Python application or script.
- Integrate Samsung TV control into a larger smart-home orchestration platform via async APIs.
- Manage Art Mode on Frame TVs—upload images or toggle the feature from a custom application.
- Build CLI tooling to quickly test TV connectivity and send remote commands for debugging or scripting.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own a compatible Samsung TV and need programmatic control.
The library is actively maintained, has low install friction, and covers a broad range of TV models and control scenarios. The LGPL-3.0 license is permissive for most use cases but requires derivative works to remain open-source. The main gotcha is the subnet restriction—your TV must be on the same network as your client.
Install
samsungtvws on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. Active maintenance with a recent commit on 2026-08-08 and 419 repository stars. Requires Python >= 3.9.
TV must be on the same subnet as the client; WebSocket connections across different subnets or VLANs are not supported by Samsung TVs.
License in practice
Licensed under LGPL-3.0 (copyleft). Any derivative work or modification must remain open-source under the same license; proprietary applications using this library must comply with copyleft obligations.
Quickstart
pip install samsungtvws
from samsungtvws import SamsungTVWS
tv = SamsungTVWS(host="192.168.1.50")
tv.power()Verify before relying
- Whether the library works reliably with all Tizen OS TVs from 2016 onward or if specific TV models have known compatibility issues.
- Performance characteristics when controlling multiple TVs concurrently or sending rapid command sequences.
- Whether the encrypted v1 API for older Orsay TVs (H series 2014, J series 2015) is actively maintained or deprecated.
Package facts
| License | LGPL-3.0 copyleft |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packageswebsocket-clientrequestsyarl |
| Maintenance | Actively maintained 78 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 117,705 / month, #12,154 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersProgramming Language :: Python :: 3 |
Evidence: samsungtvws-3.0.5-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “samsung tv remote control python”
- samsungtvwsA Python library for remotely controlling Samsung Smart TVs via…
- androidtvremote2A Python library for controlling Android TV devices over the network…
- aiowebostvAsync Python library for controlling LG webOS-based TV devices over…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also pyatv · pybravia · pykodi · aiowebostv · androidtvremote2 · httpx-ws · pysensibo · websockets-proxy · aioshelly · wakeonlan