---
id: aiowebostv
version: "0.9.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aiowebostv — Library to control webOS based LG TV devices

License: permissive · Maintenance: active · Downloads: 84.8K/mo

## What it is and what it does

aiowebostv is an async Python client library for controlling LG webOS-based televisions over the network. It wraps the webOS TV API to allow programmatic connection, querying device state and capabilities, and subscribing to state change events. The library is built on aiohttp for async I/O and is designed for integration into home automation systems and remote control applications.

The package handles the pairing handshake (storing a client key for future connections), exposes TV information and current state through simple object attributes, and allows registration of callbacks to react to TV state changes in real time. It is actively maintained and part of the Home Assistant ecosystem, with support for modern Python versions (3.11+).

Use it for:

- Build a home automation script that turns off your LG TV at a specific time or when leaving home.
- Monitor TV state changes in real time and trigger actions based on what's being watched or input selected.
- Integrate LG TV control into a broader Home Assistant or smart home system.
- Create a custom remote control application that queries and controls multiple webOS TVs on your network.
- Log TV usage patterns by subscribing to state updates and recording power and input changes.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Async Python library for controlling LG webOS-based TV devices over the network, supporting connection, state queries, and event subscriptions.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and solves a specific problem (LG webOS TV control) with a clean async API. It is suitable for home automation and smart home integration. No known vulnerabilities. The requirement for Python 3.11+ is a minor constraint but aligns with modern practice.

## Install

pip install aiowebostv
uv add aiowebostv
poetry add aiowebostv

## Installing aiowebostv

Before you install: Low install friction with a single runtime dependency (aiohttp). Actively maintained with recent releases; last commit 2026-08-13 and version released 2026-08-06. Requires Python 3.11 or later.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install aiowebostv

import asyncio
from aiowebostv import WebOsClient

async def main():
    client = WebOsClient("192.168.1.39", "your_client_key")
    await client.connect()
    print(client.tv_info)
    await client.disconnect()

asyncio.run(main())

Requires Python >= 3.11. Target LG webOS TV must be on the same network and accessible via IP address.

Verify before relying:

- Whether pairing/key generation is automatic or requires manual TV interaction on first connection.
- Full range of TV control operations supported (power, input, volume, apps, etc.) beyond state queries.
- Network protocol details and any firewall/port requirements for TV communication.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 84.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

lg webos tv control python, async lg tv remote library, webos tv automation, lg tv network control, home automation lg tv, webos tv state monitoring, lg tv python client, home-automation, lg-tv, async-io

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