homebridge-securitysystem

Homebridge plugin that creates a security system accessory that can be triggered by HomeKit sensors.

Usage no npm install needed!

<script type="module">
  import homebridgeSecuritysystem from 'https://cdn.skypack.dev/homebridge-securitysystem';
</script>

README

homebridge-securitysystem

npm version npm downloads verified-by-homebridge

Homebridge plugin that creates a security system accessory that can be triggered by HomeKit sensors.

❤️ One-time donation

Installation

If you already have Homebridge installed, execute the following command:

npm i -g --unsafe-perm homebridge-securitysystem

Demo

Want to know how it looks like? It's pretty customizable, you can configure it to show as many switches as you like.

What you are seeing at your right it's the friendliest configuration that you can start with, each Siren switch that you see can only trigger the security system if the mode is set on the security system. This allows you to create logic-less automations from the very Home app that comes already installed on iOS.

There are also Mode switches which let you run automations that interact with your accessories when a mode is changed or set modes bypassing HomeKit confirmation dialogs.

A web server, webhooks or even shell commands are available to integrate the security system with other devices or services plus a plenty of more settings to make this plugin your own DIY security system.

Homebridge / HOOBS UI is recommended to configure the plugin, for additional help please check the Wiki page.

Automations

Using the Home app is recommended for regular users, for more advanced users the Eve or a similar app will let you make use of the custom options that the security system itself exposes.

Here are some examples of automations that can be created:

Trigger Actions
Motion is Detected Turn on Siren Night
Door is Opened Turn on Siren Away
NFC Tag is Detected (1) Set Security system to Home
Security System Triggers Play Audio (2)

(1) Shortcuts app is required to create this automation.

(2) AirPlay 2 speaker and Apple Music subscription are required.

IMPORTANT: Use an NFC tag to arm/disarm the security system easily and securely without using the Home app.

Contributions

Pull requests are welcome.