Skip to main content

Satel Integra: Asynchronous python client for Satel Integra

PyPI - Version Pypi - Python Versions Licence

Build Status Open in Dev Containers

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)

Source distribution for satel-integra 1.7.0
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)

Table of built distributions (wheels) for satel-integra 1.7.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page