This plugin is still work in progress. See the todos and known issues below. Development of this plugin might be slow due to some personal issues.

Homebridge Slide Remote

A homebridge plugin to use the Slide curtain motor in HomeKit using Homebridge.

The name is "Slide Remote" on purpose, this version uses the open cloud API (V1.0) that is provided by Innovation in Motion.

Once the local API or module API (for the header pins) becomes available I will likely abandon development of this version of the plugin and instead use the local API because of privacy, reliability and responsiveness.

Installation

The following command can be used to install the plugin on the Homebridge server:

npm install -g homebridge-slide-remote

After that you will need to enter the following details into the ~/.homebridge/config.json:

{
  "platforms":[
         {
             "platform": "slide-remote",
             "username": "EMAIL",
             "password": "PASSWORD"
         }
     ]
 }

Now start of restart homebridge and all slides connected to your account should appear in the HomeKit app.

Known Issues

The expiration of the access token isn't currently handled. This means the homekit accessory will stop working a month after the launch of Homebridge. Restarting homebridge will fix this issue.
The code is far from perfect or optimized, my knowledge of NodeJS isn't the best.

I've currently implemented a work around for the following issues, however I'm still testing it

Opening/closing the curtains using the Slide app or other plugins does not currently reflect the state correctly in HomeKit.
HomeKit apps will sometimes incorrectly report that the curtain is still moving, while it is already done opening.

Please let me know if you are expieriencing the above issues.

Todo

Handle expiration of the access token.
Save the access token (and expiration date) somewhere in homebridge instead of requesting it every restart.
Correctly report errors by marking the accessory as "Not responding" in the Home app.
Move to the new OAuth method when available.

renssies / homebridge-slide-remote Goto Github PK