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.

Release files for qolsys-controller 1.8.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qolsys-controller 1.8.3
File	Size	Uploaded
qolsys_controller-1.8.3.tar.gz	106.4 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for qolsys-controller 1.8.3
File	Interpreter	ABI	Platform	Reset
qolsys_controller-1.8.3-py3-none-any.whl 147.0 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 253.4 kB

Release files / qolsys_controller-1.8.3.tar.gz

Download URL	qolsys_controller-1.8.3.tar.gz
Size	106.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`a61a48cca0f3ba7b3f6158550b5aee8fe07259ccb1cee3124b58792f815b1955`
BLAKE2b-256 checksum How to use checksums	`a9ea7aad0957c9fe2eb4bcdafce4f3dce515fed2fb4f76e7d7db5793dc214379`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/EHylands/QolsysController
Publishing commit: github.com/EHylands/QolsysController/tree/265a5a08c4e502a4ed44cc6ceb38dacc4d737d23

Workflow

Publishing configuration: github.com/EHylands/QolsysController/blob/265a5a08c4e502a4ed44cc6ceb38dacc4d737d23/.github/workflows/publish.yml
Publishing logs: github.com/EHylands/QolsysController/actions/runs/35164806160/attempts/1

Artifact

Subject: qolsys_controller-1.8.3.tar.gz
SHA-256 checksum: a61a48cca0f3ba7b3f6158550b5aee8fe07259ccb1cee3124b58792f815b1955 Verifying attestations

Release files / qolsys_controller-1.8.3-py3-none-any.whl

Download URL	qolsys_controller-1.8.3-py3-none-any.whl
Size	147.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`76ab73270d3bcce5240b8b319a2bc05cb92ecd89c14c65c6d392cacff0f3dbd5`
BLAKE2b-256 checksum How to use checksums	`b6f5edd7c760dea5f12b8169ee0415bd0014c80a6ac0e86e7cbc0b5dd2b7e83b`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/EHylands/QolsysController
Publishing commit: github.com/EHylands/QolsysController/tree/265a5a08c4e502a4ed44cc6ceb38dacc4d737d23

Workflow

Publishing configuration: github.com/EHylands/QolsysController/blob/265a5a08c4e502a4ed44cc6ceb38dacc4d737d23/.github/workflows/publish.yml
Publishing logs: github.com/EHylands/QolsysController/actions/runs/35164806160/attempts/1

Artifact

Subject: qolsys_controller-1.8.3-py3-none-any.whl
SHA-256 checksum: 76ab73270d3bcce5240b8b319a2bc05cb92ecd89c14c65c6d392cacff0f3dbd5 Verifying attestations