Satel Integra: Asynchronous python client for Satel Integra
About
Communication library and basic testing tool for Satel Integra alarm system. Communication via TCP/IP protocol published by SATEL.
Installation
pip install satel_integra
Usage
To use Satel Integra in a project, follow the example, replace values where needed:
from satel_integra import AsyncSatel
For complete examples, look into the examples folder.
Scanning panel resources
After connecting and starting the client, scan the resource types you need:
zones = await satel.scan_zones()
outputs = await satel.scan_outputs()
partitions = await satel.scan_partitions()
Each individual scan returns a list of SatelZoneInfo, SatelOutputInfo, or
SatelPartitionInfo objects respectively, ordered by ascending device_number.
Omitted resources leave no placeholders; an empty result is []. List positions
are not resource numbers: use each object's device_number field.
Scans use panel capacities cached at startup and raise an error if panel
information is unavailable or the panel model is unknown.
All scan methods accept an optional synchronous on_progress(completed, total)
callback. Progress counts completed address reads, including addresses omitted
from the result; it does not count discovered devices. Outputs with type code
zero are omitted. The existing scan behavior also omits addresses rejected with
the generic 0x08 result, which panels have been observed to return for unused
addresses. Other read failures and cancellation propagate without returning a
partial result.
Scanning only retrieves metadata; it does not change which resources the client monitors. To read the full panel inventory, call all three methods sequentially, as shown above. Each method reports progress independently; callers decide how to combine results and whether to continue if one scan fails.
Contributing
Contributions are welcome! If you want to contribute, have a look at the contribution file.
License
Refer to the licence file.
Features
- Zone violation state
- Output states + toggling
- Alarm panel status + arming/disarming
- Encrypted connections
- Auto reconnecting
- Zone temperature reading
- Zone tamper/bypass states
- System faults (bad battery, AC trouble, other errors)
- System info (panel information, firmware version etc)
- Event monitoring
Credits
Original creator of the library is Krzysztof Machelski
All contributors are listed on the contributor's page
Metadata
Release files for satel-integra 1.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| satel_integra-1.7.0.tar.gz | 84.9 kB | With provenance | Details for satel_integra-1.7.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| satel_integra-1.7.0-py3-none-any.whl | Python 3 | none | any | Details for satel_integra-1.7.0-py3-none-any.whl |
Total release size: 132.0 kB
Release files / satel_integra-1.7.0.tar.gz
| Download URL | satel_integra-1.7.0.tar.gz |
|---|---|
| Size | 84.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
549e5a86dd397647b2e1c1c884ca7813060879536585d72980228d000db33bd4
|
|
BLAKE2b-256 checksum How to use checksums |
3bc435029b05eb56f0d11fcacddbbcb1fbfa442ebf42ea1f8ae58ede9179826b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.
Transparency logRelease files / satel_integra-1.7.0-py3-none-any.whl
| Download URL | satel_integra-1.7.0-py3-none-any.whl |
|---|---|
| Size | 47.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c937cc9ea97397c245075f80f7a0cd3b899f3d3fa54967c727d4dc403d4d4770
|
|
BLAKE2b-256 checksum How to use checksums |
7548d74e21a0b904830888479637c657b9c5d6ba2ebaba9573327bc6d851ab98
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.
Transparency logSecurity for satel-integra 1.7.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for satel_integra-1.7.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.