Skip to content

apexad/homebridge-mysmartblinds-bridge

Repository files navigation

Homebridge Verified

homebridge-mysmartblinds-bridge

mit license npm npm verified-by-homebridge donate

Homebridge plugin which communicates with MySmartBlinds through the MySmartBlinds Smart Bridge.
Configure your blinds and bridge with the official iOS or Android app first in order to use this Homebridge plugin.

This plugin is not affiliated with the MySmartBlinds product.

Features

  1. Uses bridge to auto-detect all blinds setup in the MySmartBlinds app, no need to specify each blind
  2. Supports blind percentages
  3. Shows battery level for each blind (updated only when blind is open/closed)
  4. Issues a low battery indicator if battery is below 20%
  5. Logging (via Homebridge) of all actions done
  6. Blinds can close down or up (via config option)
  7. Polling so that blinds update if changed outside of HomeKit

Notes

  1. Use the 'MySmartBlinds' app to calibrate a blind if it is not opening perfectly straight
  2. If switching to closeUp it's best to Open all blinds first and then restart Homebridge
  3. If you see duplicate blinds, make sure to delete any 'disconnected'/invalid blinds within the iOS/Android app. (see #23)
  4. Polling Interval will be ignored if the (auth0) API Rate Limit Policy is reached

Configuration

This easiest way to use this plugin is to use homebridge-config-ui-x.
To configure manually, add to the platforms section of Homebridge's config.json after installing the plugin.

Config:

{
  "platform": "MySmartBlindsBridge",
  "name": "MySmartBlindsBridge",
  "username": "<email address>",
  "password": "<password>"
}
Field Description
platform Must always be "MySmartBlindsBridge"
name Best to set to "MySmartBlindsBridge"
username MySmartBlinds app username (usually email address)
password MySmartBlinds app password
closeUp (optional true/false, defaults to false) Blinds close in the upwards position
statusLog (optional true/false, defaults to false) logs position changes
allowDebug (optional true/false, defaults to false) Outputs a lot of debug info to stdout
pollingInterval (optional) Polling Interval (in minutes)

Testing

Use npx homebridge-mysmartblinds-bridge to test your credentials.

Sponsors

mrferreira89 (reddit user) - primary tester/sponsor and provided project hardware
gregmichael - sponsor and tester
name99-org - sponsor

Code credits

ianlevesque/smartblinds-client - used to understand mysmartblinds bridge API
Nicnl/homebridge-minimal-http-blinds - used as an example of blind accessory
crashtestoz/homebridge-http-window-blinds - also used as an example of blind accessory homebridge/homebridge-plugin-template - v2.0 rewrite based on this template