Snarl Files

HomeAlone

Overview

HomeAlone integrates your HomeKit devices into Snarl. To do this, it relies on some other components:

• HomeBridge (https://github.com/nfarina/homebridge)
• The httpeverything plugin for HomeBridge (https://www.npmjs.com/package/homebridge-httpeverything)

General operation is as follows:

• You add further pseudo devices to your HomeKit home via HomeBridge and the httpeverything plugin
• When one of the pseudo devices is interacted with, HomeBridge signals HomeAlone
• HomeAlone detects the interaction and sends a notification to Snarl

Setting Up

If you don't already have HomeBridge set up, you can find instructions in [1] below. HomeBridge ideally needs to run on a device that will always be powered on - something like a Raspberry Pi or similar is perfect.

Once HomeBridge is up and running, you can install the httpeverything plugin - the download page also includes a sample configuration.

Creating Pseudo Accessories

Integration between HomeKit and HomeAlone relies on pseudo accessories that are triggered manually or automatically. The iOS Home application allows you to group accessories so you can combine the real accessory and the virtual one together.

Configuring HomeAlone

Example

Add the following configuration to the httpeverything Accessories section of the HomeBridge configuration file:

{
    "accessory": "Httpeverything",
    "service": "Switch",
    "name": "Woofer",
    "apiBaseUrl": "http://192.168.1.16:5555/test",
    "apiSuffixUrl": ""
}

Replace server with the hostname or IP address of the machine HomeAlone is running on. If you've changed the port HomeAlone is using, make sure you change the 5555 to match that as well.

References

• [1] HomeBridge installation:
• [2] httpeverything plugin:

Commands

• -b Port to listen on for incoming Homebridge requests (default is 5555)
• -h Host name of where to send notifications (default is 127.0.0.1)
• -p Port number of where to send notifications (default is 31000)

Other options

• --new Creates a sample configuration file

Notes

Screenshot