Homebridge HTTP Window Covering

A very simple Homebridge plugin for controlling window covering over HTTP. This plugin is statefull, it keeps the status of the window covering locally. No server side checking will be done to get states and positions from the window covering. Only setters will use HTTP requests.

IMPORTANT

• Requires Node.js >= 7.6.0
• If you're seeing errors then please check your node version before creating a new issue: node -v.

Installation

• Install homebridge: sudo npm install -g homebridge
• Install this plugin: sudo npm install -g homebridge-http-window-covering
• Update your configuration file. See config sample below.

Config sample

{
    // ...
    "accessories": [
        {
            // Required
            "accessory": "HttpWindowCovering",
            "name": "My Blinds",
            "urlSetTargetPosition": "http://192.168.1.100/set/%VALUE%",

            // Optional
            "outputValueMultiplier": 0.8
        }
    ],
    // ...
}

Under the hood

When setting the target position the url from the config will be used. %VALUE% will be replaced will the value passed by your Homekit app. This will be a value between 0 and 100 depending on the status of your window covering. Once the HTTP request was done, the current position will be updated so the Homekit app will complete and can take another request. There is no time-out for this request.