Metadata-Version: 2.4
Name: OWNd2
Version: 0.7.82
Summary: Python interface for the OpenWebNet protocol
Author: smf666
License-Expression: GPL-3.0-only
Project-URL: Source code, https://github.com/smf666/OWNd
Classifier: Programming Language :: Python :: 3.9
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp
Requires-Dist: pytz
Requires-Dist: python-dateutil
Requires-Dist: pyserial-asyncio-fast
Dynamic: license-file

# OWNd

This package is an event listener and command forwarder for the OpenWebNet protocol.

It is mainly intended to be used in an Home-Assistant integration.

At this point most events are understood.
WHO = 5 (Burglar Alarm) event support is limited and needs further development.
Many commands are implemented, mostly within the requirements of Home-Assistant.

## Testing OWNd

Testing OWNd is pretty simple. 
Clone this repository and then:

```
cd <OWNd checkout folder>
pip3 install .
python3 -m OWNd --help    # to visualize possible options
```

To attempt connection to the first available OpenWebNet gateway in the local area network you 
can run:

```
python3 -m OWNd
```

This will use [SSDP](https://en.wikipedia.org/wiki/Simple_Service_Discovery_Protocol) to discover
all supported gateways and pick the first one.

Alternatively, if you want to skip the SSDP discovery step, you can provide the IP address, port 
and MAC address of the gateway from command-line:

```
python3 -m OWNd --address <IP address> --port <PORT> --password <PASS> --mac <MAC address>
```

Note that all these details can be retrieved using bTICINO Home+Project Android application.
