Skip to content
fullphat edited this page May 10, 2017 · 2 revisions

logo

About...

Abode creates a small web server that listens on a particular port for a specially-formatted HTTP GET request from Homebridge. This allows you to intercept updates and status requests from 'virtual' accessories you create, which you can then use to trigger notifications or other actions within Snarl.

Homebridge is a lightweight NodeJS server you can run on your home network that emulates the iOS HomeKit API. It supports Plugins, which are community-contributed modules that provide a basic bridge from HomeKit to various 3rd-party APIs provided by manufacturers of 'smart home' devices.

Setting up...

Firstly, you will need a Homebridge installation. Homebridge is probably best supported on small IoT devices that run Linux (such as Raspberry Pi's running Raspbian), although it is supported on other operating systems. This guide will talk you through getting Homebridge set up on a Pi.

Configuring Homebridge

Abode is designed to work with the HttpEverything Homebridge plugin. Install the plugin as follows:

npm install -g homebridge-httpeverything

Creating an Accessory (Part 1)

The easiest way to create an accessory is to first create it in Abode. Launch Abode from a Windows Command Prompt and navigate to its admin console (http://localhost:6060/ by default) and click the big "+" button to add a new accessory. Give the accessory a name and select a type (we recommend creating a light or switch initially) and click Save.

You can now edit additional settings for the accessory, but for now just click on Homebridge configuration and copy and paste the content of the textbox into your Homebridge config.json file. Save the file and launch Homebridge.

Creating an Accessory (Part 2)

Once Homebridge has started up, you should see a new accessory appear in your iOS Home app. Try switching it on and off: you should see notifications from Snarl appear on your desktop. Congratulations! You've just created your first accessory!

Clone this wiki locally