Metadata-Version: 2.4
Name: schideron
Version: 0.1.0
Summary: Async Python SDK for Schideron local UControl gateways
Project-URL: Documentation, https://github.com/Menci/schideron-python/blob/main/docs/protocol.md
Project-URL: Issues, https://github.com/Menci/schideron-python/issues
Project-URL: Source, https://github.com/Menci/schideron-python
License-Expression: MIT
License-File: LICENSE
License-File: NOTICE
Keywords: home-assistant,schideron,socket.io,ucontrol
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: AsyncIO
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Home Automation
Requires-Python: >=3.12
Requires-Dist: aiohttp<4,>=3.12
Description-Content-Type: text/markdown

# schideron

`schideron` is an unofficial async Python SDK for controlling Schideron
UControl gateways over the local network. It supports gateway discovery,
air conditioners, floor heating, relay commands, and status telemetry.

## Usage

Install the package:

```console
uv add schideron
```

Discover and connect to a gateway:

```python
import asyncio

from schideron import SchideronClient, discover_gateways


async def main() -> None:
    gateway = (await discover_gateways())[0]
    async with SchideronClient(gateway.host, port=gateway.port) as client:
        await client.wait_until_ready()
        print(client.conditioners)


asyncio.run(main())
```

See [the protocol reference](docs/protocol.md) for device support and command
confirmation semantics.
