aiowebostv

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 on this page — 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

aiowebostv on PyPI

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

Evidence: aiowebostv-0.9.1-py3-none-any.whl

Tags

More Home Automation packages