Flair Smart Vent plug-in for Homebridge using the Flair API.

1. Install homebridge using: npm install -g homebridge
2. Install this plug-in using: npm install -g homebridge-flair
3. Update your configuration file. See example config.json snippet below.

Configuration sample (edit ~/.homebridge/config.json):

{
    "platforms": [
        {
            "clientId": "client_id",
            "clientSecret": "client_secret",
            "username": "user",
            "password": "pass",
            "pollInterval": 60,
            "platform": "Flair",
            "ventAccessoryType": "windowCovering"
        }
    ]
}

In order to use this plugin you will need to obtain a client id and client secret from Flair.

Start by creating a Flair account at my.flair.co (if you haven't already), then use this web form to request credentials.

More API docs and details

When you use Pucks with your setup the pucks will appear in the app as a Thermostat. If you turn those thermostats off it will put the Flair system into Manual mode. If you turn the thermostat to any other setting it will set your system to Flair's Auto mode.

You can specify how vent accessories are shown in HomeKit with the ventAccessoryType property.

windowCovering - Window Covering fan - Fan airPurifier - Air Purifier

Commits should be formatted as type(scope): message

The following types are allowed:

A new version is released when a merge or push to main occurs.

We use the rules at default-release-rules.js as our guide to when a series of commits should create a release.