Qolsys

Qolsys IQ Panel

homebridge-qolsys · v0.5.2

VerifiedLocalHomebridge 2.0

Adds Qolsys IQ Panel partitions and RF/wired sensors to HomeKit as a security system.

View on npm Source code

What it says it supports

Brands

Qolsys

Devices it names

IQ2
IQ2+
IQ4
IQ4 HUB (pending)
IQ4 NS (pending)
IQ Pro (pending)
IQ Doorbell sensor

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Qolsys IQ panels work; doorbell sensor support was added and IQ Pro needs Control4 enabled via dealer code.

Works6
Partly works1

Device	Status	What they said	Source
Qolsys alarm panel	Works	Direct panel plugin faster than alarmdotcom, gives open/close sensor alerts; needs installer code for device ID Saved copy Got it configured, much better way, in my opinion, than the alarmdotcom plugin. I would have alarmdotcom alerts for door sensors but I've removed those and I receive both open and closed alerts from HomeKit now, much faster too. Thanks, this plugin didn't exist back in 2021 when I was setting up my Homebridge. Now I just need to find a way to control my z-wave lights, those are the only ones not ignored since I don't have a way to control them without the alarmdotcom plugin... Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.	Reddit comment · 2024-01
Qolsys IQ Doorbell sensor	Works	Doorbell accessory added in 0.5.0-beta.0; maintainer tested with simulation Saved copy Just a couple added notes. The IQ Doorbell sensor is likely just a regular sensor configured to detect when the circuit for a door bell is completed, kind of like a water sensor. @EHylands I assume you simulated it by just using a regular contact sensor, and telling the IQ panel that it is a doorbell sensor? If not that should be possible to basically see it end to end, it is going to be a normally open sensor and when the contact is closed is the button press. Due to how it works and how most doorbell cameras work, the sensor is likely not compatible with using a doorbell camera _unless_ the … Excerpt saved from GitHub on 2026-10-22.	Issue #32 · 2024-01
Qolsys IQ panel (IQ2 and newer)	Works	Local real-time panel control; Z-wave devices and web integrations do not show up Saved copy Setting up home assistant as a secondary hub has already been done and is very easy to do. Here is a guide from 2020 that explains in detail how to set this up. Secondary Controller Guide Before you do this please note that there there are some limitations to having a secondary controller. Some devices can only report to node #1 in the network. So if you had a motion detector it would only report motion updates to your Qolsys panel and not HA. Another limitation is that some devices only allow you to report to one device. This means you could either report to your Qolsys panel or HA but not … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.	Reddit thread · 2022-12
Qolsys IQ Pro panel	Works	Works once Control4 is enabled using installer dealer code Saved copy I'm considering an IQ Pro instead of a IQ Panel 4 and was wondering if this homebridge plugin will have pending support for the Pro. I see the Hub is marked as support pending already. Thanks! Hi, I wrote ´status pending' for IQ4 Hub because no one reported using it with the plugin yet ... In spec, it's stated that Control4 is still an integration partner for IQ pro, but I can't find any procedure in installation guide to enable the feature. The Control4 integration has been fairly consistent between all supported panels and official driver hasn't been updated in a long time. IQ pro might … Excerpt saved from GitHub on 2026-10-22.	Issue #30 · 2023-11
Qolsys motion sensors	Works	Exposed as motion and/or occupancy sensors Saved copy Present Qolsys motion sensor with the following options: Homekit motion sensor only Homekit =occupancy sensor only Homekit motion and occupancy sensors Sensor trigger duration is selectable for each sensor type * This change is disruptive for previously established motion sensor Homekit automations * Excerpt saved from GitHub on 2026-10-22.	PR #23 · 2023-07
Qolsys tilt sensors	Works	Can be mapped as normal contact sensors Saved copy The original text was already deleted or overwritten when we archived it.	PR #21 · 2023-07
Qolsys IQ Panel 4 Hub	Partly works	Listed as support pending; no one had confirmed it Saved copy I'm considering an IQ Pro instead of a IQ Panel 4 and was wondering if this homebridge plugin will have pending support for the Pro. I see the Hub is marked as support pending already. Thanks! Hi, I wrote ´status pending' for IQ4 Hub because no one reported using it with the plugin yet ... In spec, it's stated that Control4 is still an integration partner for IQ pro, but I can't find any procedure in installation guide to enable the feature. The Control4 integration has been fairly consistent between all supported panels and official driver hasn't been updated in a long time. IQ pro might … Excerpt saved from GitHub on 2026-10-22.	Issue #30 · 2023-11

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local

Panel's local Control4 integration interface

You’ll need

Qolsys IQ2/IQ4 panel
Control4 integration enabled on panel
Panel access token
6-digit user codes (newer firmware)

Compatibility

Verified by Homebridge	Yes
Homebridge versions	^1.6.0 \|\| ^2.0.0-beta.0
Homebridge 2.0	Yes
Node.js	^20.15.1 \|\| ^22.0.0 \|\| ^24.0.0
Settings in Homebridge UI	Yes
Matter	No
Platform name	QolsysPanel
License	MIT

Community signals

Downloads a week	7
Downloads a month	28
GitHub stars	32
Open issues	2
Closed issues	35
Last code push	2026-02-28
Latest version	0.5.2 (2026-02-28)
First published	2022-10-07
Releases	41

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

Caveats from the README

No Z-Wave or IQ smart home features
Arming Away may become Stay via Auto Stay
Must disarm before switching armed modes unless exit delay is 0

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

CarbonMonoxideSensor
ContactSensor
Doorbell
LeakSensor
MotionSensor
OccupancySensor
SecuritySystem
SmokeSensor
StatelessProgrammableSwitch

Sources

npm: https://www.npmjs.com/package/homebridge-qolsys
Source code: https://github.com/EHylands/homebridge-qolsys
Issues: https://github.com/EHylands/homebridge-qolsys/issues
Homepage: https://github.com/ehylands/homebridge-qolsys#readme
Verified plugins list: https://github.com/homebridge/verified