Qolsys Controller
A Python module that emulates a virtual IQ Remote device, enabling full local control of a Qolsys IQ Panel over MQTT.
QolsysController
- ✅ Connects directly to the Qolsys IQ Panel's local MQTT interface as an IQ Remote
- 🔐 Pairs by only using Installer Code (same procedure as standard IQ Remote pairing)
- 🔢 Supports 4-digit user codes
- ⚠️ Uses a custom local usercode database (panel internal validation is not yet supported)
- 🌐 Now includes a built-in MQTT Bridge - MQTT Bridge, enabling seamless publishing of panel updates and handling of incoming commands
📦 Installation
Please check Advanced instructions
pip install qolsys-controller
qolsys-controller --verbose --config 'path_to_config_file'
Troubleshooting
Functionality Highlights
| Category | Feature | Status |
|---|---|---|
| Panel | Diagnostic Sensors | ✅ |
| Panel Scenes | ✅ | |
| Speak Command | ✅ | |
| Weather Forecast | ✅ | |
| Partition | Arming Status and Alarm State | ✅ |
| Home Instant Arming | ✅ | |
| Home Silent Disarming (Firmware 4.6.1) | ✅ | |
| Set Exit Sounds and Entry Delay | ✅ | |
| Zones | Sensor Status | ✅ |
| Tamper State | ✅ | |
| Battery Level | ✅ | |
| Temperature (supported PowerG device) | ✅ | |
| Light (supported PowerG device) | ✅ | |
| Average and Latest dBm | ✅ |
| Automation Devices | Z-Wave | PowerG | Zigbee | Alarm.com |
|---|---|---|---|---|
| Door Lock | ✅ | ✅ | ✅ | ❌ |
| Energy Clamp | ✅ | ❌ | ❌ | ❌ |
| External Siren | ✅ | ❌ | ❌ | ❌ |
| Garage Door | ✅ | ❌ | ❌ | ✅ |
| Light | ✅ | ✅ | ✅ | ✅ |
| Smart Outlet | 🛠️ | ❌ | ❌ | ❌ |
| Thermometer | ✅ | ❌ | ❌ | ❌ |
| Thermostat | ✅ | ❌ | ❌ | ❌ |
| Water Valve | 🛠️ | ❌ | ❌ | ❌ |
🛠️ = partially supported or untested
⚠️ Certificate Warning
During pairing, the main panel issues only one signed client certificate per virtual IQ Remote. If any key files are lost or deleted, re-pairing may become impossible.
A new PKI, including a new private key, can be recreated under specific circumstances, though the precise conditions remain unknown at this time.
Important:
Immediately back up the following files from the pki/ directory after initial pairing:
.key(private key).cer(certificate).csr(certificate signing request).secure(signed client certificate).qolsys(Qolsys Panel public certificate)
Store these files securely.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file qolsys_controller-1.6.1.tar.gz.
File metadata
- Download URL: qolsys_controller-1.6.1.tar.gz
- Upload date:
- Size: 102.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8459c46b80bc6b43c6a6656e492f5eb123c23f234c0c61b38748e2762d943e72
|
|
| MD5 |
87690a8e8d221f7c45c1d61b24aca27a
|
|
| BLAKE2b-256 |
a89b24b207d77e47f2101b2267bf12e8bffaf8771439f1dffa308f4d6ba041f9
|
Provenance
The following attestation bundles were made for qolsys_controller-1.6.1.tar.gz:
Publisher:
publish.yml on EHylands/QolsysController
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qolsys_controller-1.6.1.tar.gz -
Subject digest:
8459c46b80bc6b43c6a6656e492f5eb123c23f234c0c61b38748e2762d943e72 - Sigstore transparency entry: 2361796087
- Sigstore integration time:
-
Permalink:
EHylands/QolsysController@0e211682b6c4312028b09d19e063eeedf6dd233f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/EHylands
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@0e211682b6c4312028b09d19e063eeedf6dd233f -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file qolsys_controller-1.6.1-py3-none-any.whl.
File metadata
- Download URL: qolsys_controller-1.6.1-py3-none-any.whl
- Upload date:
- Size: 143.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f6f127d72984827575e9ce4d6541e3ccb81f2e0d0252ba49099346b251291ab
|
|
| MD5 |
f4c8b4434e1d8c0c22cdf690c9fcb47a
|
|
| BLAKE2b-256 |
6888d249431423130e808c25896836ec4e56e9d56e2fea7aa1304852e115aac8
|
Provenance
The following attestation bundles were made for qolsys_controller-1.6.1-py3-none-any.whl:
Publisher:
publish.yml on EHylands/QolsysController
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qolsys_controller-1.6.1-py3-none-any.whl -
Subject digest:
3f6f127d72984827575e9ce4d6541e3ccb81f2e0d0252ba49099346b251291ab - Sigstore transparency entry: 2361796098
- Sigstore integration time:
-
Permalink:
EHylands/QolsysController@0e211682b6c4312028b09d19e063eeedf6dd233f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/EHylands
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@0e211682b6c4312028b09d19e063eeedf6dd233f -
Trigger Event:
workflow_dispatch
-
Statement type:
