LouwHopley / homebridge-olarm-plugin

A HomeKit interface for an [Olarm](https://olarm.co) alarm system.
MIT License
3 stars 3 forks source link

homebridge-olarm-plugin

This plugin creates a HomeKit interface for an Olarm alarm system.

Guide

Installing

  1. On your Homebridge device, run npm i -g homebridge-olarm-plugin
  2. Create an API key on Olarm (here)
  3. Set up the new platform in your Homebridge config.json
    {
    "platform": "OlarmHomebridgePlugin",
    "name": "homebridge-olarm-plugin",
    "apiKey": "<YOUR OLARM API KEY>"
    }
  4. Restart your Homebridge

Usage

The plugin will automatically scan all devices on your Olarm account and pull in their areas. Each area will be created as a separate accessory.

Note that HomeKit forces 4 alarm states: Home, Away, Night and Off which as of writing can't be customised. Hence, the states have been mapped to the following:

Triggered / alarm activated states are not yet connected.

Development

Follow the below instructions if you want to fork and evolve this plugin.

Note: YMMV with setup guides below

  1. Clone the repo onto your device that hosts your Homebridge instance.
  2. Run npm install to install dependencies.
  3. Run npm run watch to have nodemon run and keep it updated. It also runs npm link.

Now to plug it into your Homebridge

  1. Run npm run build to build the plugin into /dist (npm run watch will do the same)
  2. Run pwd to get the full path to the plugin (e.g. /home/pi/HomebridgePlugins/olarm-plugin)
  3. Inside Homebridge's directory, Run npm link if needed sudo npm link <path from step 2>
  4. Update the Homebridge config.json with this platform:
    {
    "platform": "OlarmHomebridgePlugin",
    "name": "homebridge-olarm-plugin",
    "apiKey": "<use your olarm api key>"
    }
  5. Restart your Homebridge sudo systemctl restart homebridge