homebridge-flair-minisplit

Flair Minisplit plug-in for Homebridge using the Flair API.

This plugin primarily deals with controlling single minisplits via Flair and Homekit and not controlling other Flair products (like vents). This plugin also delegates all the "smart" automation to you via Homekit automation and uses the Flair puck devices as plain wifi bridges to issues commands to the minisplit. This allows you to set specific schedules, set points, and more directly without worrying the Flair "automation" will overwrite your settings.

Each room (set up via the Flair app or website) is assumed to be unique minisplit for control. This plugin makes the assumption each room in Flair has a minisplit which is controlled by one Flair puck.

Credit to homebridge-flair for the original code and Flair API library. This repo is forked from it.

Installation

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

Configuration

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

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

Obtaining Credentials

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

Follow the instructions here.

Specifically you need to:

1. Create a Flair account with a developer email address at my.flair.co.
2. Provide this email address to [email protected] and they will send you a set of developer credentials.

You will use the client id and secret they send you in the config block above.