---
id: samsungtvws
version: "3.0.5"
license: LGPL-3.0
license_treatment: copyleft
maintenance: active
---

# samsungtvws — Samsung Smart TV WS API wrapper

License: copyleft · Maintenance: active · Downloads: 117.7K/mo

## 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 above — verify before relying.

A Python library for remotely controlling Samsung Smart TVs via WebSocket and REST APIs, supporting both modern Tizen OS TVs and older Orsay-based models with sync, async, and encrypted API options.

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

pip install samsungtvws
uv add samsungtvws
poetry add samsungtvws

## Installing samsungtvws

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.

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()

TV must be on the same subnet as the client; WebSocket connections across different subnets or VLANs are not supported by Samsung TVs.

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_current
- Install friction: low
- Maintenance: active
- Downloads: 117.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

samsung tv remote control python, websocket tv api wrapper, smart tv automation library, samsung tizen os control, tv device integration python, home-automation, device-control, websocket-api

[View on SkillFed](https://skillfed.io/packages/samsungtvws) · [View on PyPI](https://pypi.org/project/samsungtvws/)