suretyhome/iqmate repository overview

⁠IQ Mate (Qolsys IQ Panel Integration & Automation Tool)

IQ Mate is a tool to help serious home automation folks make the most of their Qolsys IQ Panel. Use it to create advanced automations that can’t be done in Alarm.com, and to integrate your IQ Panel with devices outside of the Qolsys & Alarm.com ecosystem.

Automations are programmed in Node-RED⁠, a visual flow-based automation editor that makes it easy to program complex automations.

⁠Get Started

Install Docker Desktop⁠.

Follow these instructions⁠ to enable the Control4 integration on your IQ Panel and get your secure token. After your IQ Panel reboots, you have 10 minutes to run IQ Mate and connect to the IQ Panel. If you don't connect within 10 minutes then the IQ Panel will automatically disable the Control4 integration and you'll have to start over.

Use this command to run IQ Mate:

docker run --rm -it \
    -p 1880:1880 -p 1883:1883 \
    -v <Working Directory>:/iqmate -w /iqmate \
    -e IQPANEL_HOST=<IQ Panel Host> -e IQPANEL_TOKEN=<IQ Panel Secure Token> \
    suretyhome/iqmate /bin/bash

Replace these items in the command with the appropriate values for your environment.

• <Working Directory> The location/folder on your computer where IQ Mate files go. If you want to reset and start from scratch, delete everything in this folder and restart IQ Mate.
• <IQ Panel Host> The host name or IP address of your IQ Panel
• <IQ Panel Secure Token> The Control4 secure token generated on your IQ Panel

When the container starts you will get a bash shell. Use it if you want, or just leave it alone. If you exit that shell then IQ Mate will shut down.

After startup, go to localhost:1880⁠ in a web browser to use Node-RED.

⁠Using IQ Mate

See the IQ Mate Documentation⁠ for more information on using IQ Mate.

See the Node-RED Documentation⁠ to learn more about what you can do with Node-RED.