Metadata-Version: 2.1
Name: diagralhomekit
Version: 0.1.0
Summary: Apple HomeKit integration for Diagral alarm systems
License: CECILL-B
Author: d9pouces
Author-email: github@19pouces.net
Requires-Python: >=3.9,<4.0
Classifier: License :: CeCILL-B Free Software License Agreement (CECILL-B)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: HAP-python (>=4.6.0,<5.0.0)
Requires-Dist: base36 (>=0.1.1,<0.2.0)
Requires-Dist: pyqrcode (>=1.2.1,<2.0.0)
Requires-Dist: python-logging-loki (>=0.3.1,<0.4.0)
Requires-Dist: requests (>=2.28.2,<3.0.0)
Requires-Dist: sentry-sdk (>=1.18.0,<2.0.0)
Description-Content-Type: text/markdown

DiagralHomekit
==============

Allow to control your Diagral alarm systems through Homekit.

.. image:: https://pyup.io/repos/github/d9pouces/DiagralHomekit/shield.svg
     :target: https://pyup.io/repos/github/d9pouces/DiagralHomekit/
     :alt: Updates


First, you need to create a configuration file `~/.diagralhomekit/config.ini` with connection details for all Diagral systems.

```ini
[system:Home]
name=[an explicit name for this system]
login=[email address of the Diagral account]
password=[password for the Diagral account]
imap_login=[IMAP login for the email address receiving alarm alerts]
imap_password=[IMAP password]
imap_hostname=[IMAP server]
imap_port=[IMAP port]
imap_use_tls=[true/1/on if you use SSL for the IMAP connection]
master_code=[a Diagral master code, able to arm or disarm the alarm]
system_id=[system id — see below]
transmitter_id=[transmitter id — see below]
central_id=[central id — see below]

```
`system_id`, `transmitter_id` and `central_id` can be retrieved with the following command, that prepares a configuration file:

```bash
python3 -m diagralhomekit -C ~/.diagralhomekit --create-config 'diagral@account.com:password'
```

Then you can run the daemon for the first time:

```python3 -m diagralhomekit -p 6666 -C ~/.diagralhomekit -v 2```

You can send logs to [Loki](https://grafana.com/oss/loki/) with `--loki-url=https://username:password@my.loki.server/loki/api/v1/push`.
You can also send alerts to [Sentry](https://sentry.io/) with `--sentry-dsn=my_sentry_dsn`.

**As many sensitive data must be stored in this configuration file, so you should create a dedicated email address and Diagral account.**

