homebridge-homeqtt-alarm
v3.1.1
Published
Homebridge MQTT Security Alarm Plugin
Downloads
37
Maintainers
Readme
Homeqtt Alarm
Homebridge MQTT Security Alarm Plugin for HomeKit.
This plugin sets up an alarm in HomeKit, then allows you to connect Homebridge to an MQTT server and with the received messages trigger the alarm in HomeKit (if it is armed).
Features:
- Connect Homebridge to MQTT to receive messages to trigger alarm
- Choose 'armed' states (e.g. Away Arm, Stay Arm, Night Arm)
- Select sensor types (PIR or Contact Sensor)
- Give sensors a location (i.e. a nice name)
- Globally enable/disable individual sensors
- Set sensors for only certain states
- Set Away Arm, Stay Arm, Disarm from a keyfob
- Set Arm / Trigger Delay
- Trigger HomeKit alarm with the SOS button on a keyfob
- Enable/Disable a siren
Prerequisites
You have Homebridge Installed
You have an MQTT Server Running
Your MQTT server receives codes when sensors or keyfob button pushes are triggered (e.g. via 433Mhz contact sensor to Sonoff RF Bridge - see Recommended Hardware)
You have made a coffee
Installation
There are two methods to this madness...
- Automated install and configuration via Homebridge Config UI X [recommended]
- Manual install via CLI and manually updating your Homebridge configuration file
Configuration
Once the installation is complete you will need to configure the plugin:
- Config UI X Settings from your Homebridge instance.
- Manually in your config.json.
Planned Features
See the Changelog for upcoming/planned features.
Note: NFC Tag Support (arm/disarm via NFC without using the Home app) will not be a feature of this plugin but can natively be activated through iOS Shortcuts app and requires iOS 13 or above.