homebridge-wink-schmittx

Yet another Wink plugin for homebridge.

• Uses Wink API v2, and local control.
• Subscribes to Wink push notifications, instead of polling for device updates.
• Written in ES7 (arrow functions, async/await, classes).
• Accessory services and characteristics are defined declaratively.
• Supports 2 methods of authentication including API tokens obtained from developer.wink.com

Disclaimer

This is a lightly-modified version of homebridge-wink3 for my own personal use.

All credit goes to sibartlett for his excellent work!

Contents

1. Installation
2. Configuration
3. Authentication
   1. OAuth Authorization Code
   2. OAuth Password Grant
4. Device support
5. FAQ
6. Acknowledgements

Installation

Requires Node.js 6 or later.

1. Install homebridge: npm install -g homebridge
2. Install this plugin: npm install -g homebridge-wink-schmittx
3. Update your configuration file. See sample config.json snippet below.

Configuration

"platforms": [
  {
    "platform": "Wink",
    "name": "Wink",
    "username": "your@email.com",
    "password": "WINK_PASSWORD",
    "hide_groups": [
      "garage_door",
      "thermostat"
    ],
    "accessory_info": [
      {
        "device_ids": ["123456", "654321"],
        "manufacturer": "Manufacturer",
        "model": "Model",
        "serial_number": "Serial Number"
      }
    ]
  }
]

Authentication

homebridge-wink3 supports 2 methods of authentication.

• OAuth Authorization Code (Preferred)
• OAuth Password Grant

OAuth Authorization Code

This is the method of authentication preferred by Wink. Using API credentials obtained from developer.wink.com, the plugin will direct the user to authenticate via the wink.com at startup.

You need to provide the following configuration options: client_id and client_secret

Note: DO NOT use use username and password configuration options.

Obtaining a Client ID and secret

1. Create an account at developer.wink.com
2. Create an application, with the following information:

• Name: Homebridge
• Website: https://github.com/schmittx/homebridge-wink
• Redirect URI: http://<HOMEBRIDGE_IP>:8888
• Check "I agree to the terms and conditions"

3. Wait for the application to be approved (may take hours)
4. Once approved, the Client ID and Secret can be seen here.

OAuth Password Grant

If you have old Wink API credentials that support OAuth password grant.

You need to provide the following configuration options: client_id, client_secret, username and password

Device support

See DEVICES.md for more detailed information.

FAQ

Chamberlain garage opener does not seem to response to commands

Unfortunately, Chamberlain garage openers are only controllable when using a Client ID and Secret obtained from one of the official Wink apps. (Source)

Chamberlain now offer official HomeKit support using the MyQ® Home Bridge.

GoControl garage opener does not seem to response to commands

It has been reported that GoControl garage openers do not respond when using OAuth Password Grant, instead I recommend using OAuth Authorization Code. (Source)

Is Pivot Power Genius supported?

No, but checkout this other plugin.

Acknowledgements

This plugin is a crazy rewrite of those that came before:

• The original homebridge-wink plugin, maintained by KraigM
• A fork, maintained by pdlove