homebridge-hive-forever

Homebridge Hive Forever is a collection of plugins that connect to your Hive accessories via HomeBridge.

Usage no npm install needed!

<script type="module">
  import homebridgeHiveForever from 'https://cdn.skypack.dev/homebridge-hive-forever';
</script>

README

homebridge-hive-forever

This HomeBridge Plugin adds support for all your hive devices. This version deprecates the old version that required separate installations for each device.

Changelog

  • [22/12/2019] Added Hive Thermostat Boost

Testers

If you want to add support for devices that aren't supported, please contact me using the email address: winson.hero@gmail.com

About

Homebridge Hive Forever was created to be used in conjunction with your Homebridge setup. After setting up this plugin correctly you will be able to interact with your devices via the Apple Home app and via Siri voice control.

Installation

1. Install HomeBridge

Details on the installation process can be found here HomeBridge.

2. Installing this Plugin

Run this command to download homebridge-hive-forever. This includes the entire collection. You do not need to own all the devices in order to create a successful setup, you can pick the products that you want connected.

npm install -g homebridge-hive-forever

3. Configure HomeBridge

In your homebridge config.json file, add this accessory providing the username and password you use to log into https://my.hivehome.com. The following example will show you how to connect smart plug. Please look below to see a list of supported devices and replace the "product" value with the device that you want to connect.

"accessories": [
    {
        "accessory": "HiveForever",
        "product": "HiveSmartPlug",
        "name": "Plug 1",
        "displayName": "The name that you want to display on the Home app and communicate via Siri",
        "username": "YOUR_USERNAME",
        "password": "SECRET"
​    }
],

Note: Please ensure that the name matches the name you have given to the device. For example if you have renamed your Light to John's Smart Plug, then you will need to replace "Plug 1" with "John's Smart Plug", the name is case-sensitive so please make sure you enter it correctly.

4. Configuring Multiple Thermostats

If you wish to configure multiple thermostats; you must include the device id in the config object. If you don't know the device id, run the HiveThermostat config without an identifier. You will see the device id's for all thermostats printed into the Terminal window.

Due to limitation of the HIVE api, we currently can't switch between different heating states such as schedule and off, therefore the plugin will always report the thermostat under "heat" mode but this should be read as if it's currently under schedule mode.

Single

Note how we don't include the "id" key.

"accessories": [
    {
        "accessory": "HiveForever",
        "product": "HiveThermostat",
        "name": "This value doesn\'t matter",
        "displayName": "The name that you want to display on the Home app and communicate via Siri",
        "username": "YOUR_USERNAME",
        "password": "SECRET"
​    },
],

Multiple

Note how we include a unique id for each thermostat.

"accessories": [
    {
        "accessory": "HiveForever",
        "product": "HiveThermostat",
        "name": "This value doesn\'t matter",
        "id": "11111111-1111-1111-1111-111111111111"
        "displayName": "The name that you want to display on the Home app and communicate via Siri",
        "username": "YOUR_USERNAME",
        "password": "SECRET"
​    },
    {
        "accessory": "HiveForever",
        "product": "HiveThermostat",
        "name": "This value doesn\'t matter",
        "id": "22222222-2222-2222-2222-222222222222"
        "displayName": "The other thermostat",
        "username": "YOUR_USERNAME",
        "password": "SECRET"
    }
],

5. Restart HomeBridge

Restart homebridge and you should see all the devices that you have connected.

Supported Devices

Use the provided instructions but replace the "product" value with one of the following to setup the device.

Dimmable Light: HiveLight

Active / Tunable Light: HiveTunableLight

SmartPlug: HiveSmartPlug

Thermostat: HiveThermostat

Thermostat Boost: HiveThermostatBoost

Note: Coloured light bulbs are not currently supported as I do not have access to one. If you want this adding in, please don't hesitate to contact me.

FAQ

Q. Why does the name have to match the name on the Hive Dashboard? This is to allow multiple instances of the same accessory, for example you may want to connect multiple light bulbs.

Q. You do not support a device, can you add it? Yes, please contact me using the email address provided below.

Q. I'm having problems connecting my device, can you fix it? Sure, please contact me but I can't be sure that I can fix it right away.

Q. What will happen to the old modules? Maintaining them separately was getting tedious, a combined module will let me update the code faster and I do not need to roll updates across all plugins when I need to update multiple.

Q. What happened to the Hot Water plugin? I am currently working on re-implementing support for hot water as it wasn't working as expected.

Contact Me

You can reach me here: winson.hero@gmail.com