https://github.com/gormanb/homebridge-hivehome-control
Homebridge plugin to expose Hive Home features that are not natively available in Homekit; currently, this includes Hot Water and Heating Boost functions.
https://github.com/gormanb/homebridge-hivehome-control
heating hive homebridge homekit hot-water smart-home thermostat
Last synced: 3 months ago
JSON representation
Homebridge plugin to expose Hive Home features that are not natively available in Homekit; currently, this includes Hot Water and Heating Boost functions.
- Host: GitHub
- URL: https://github.com/gormanb/homebridge-hivehome-control
- Owner: gormanb
- License: apache-2.0
- Created: 2023-10-03T09:15:12.000Z (over 1 year ago)
- Default Branch: latest
- Last Pushed: 2024-12-18T23:24:43.000Z (4 months ago)
- Last Synced: 2025-01-30T19:47:39.053Z (3 months ago)
- Topics: heating, hive, homebridge, homekit, hot-water, smart-home, thermostat
- Language: TypeScript
- Homepage:
- Size: 278 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Homebridge Hive Home Control Plugin
This plugin exposes [Hive Home](https://www.hivehome.com/) features that are not natively available in Homekit; currently, this includes Hot Water and Heating Boost functions. A [Hive Hub](https://www.hivehome.com/shop/connectivity/hive-hub) and Hive account are required. Other devices such as thermostats are not handled by the plugin, since the Hive Hub already provides these as Homekit accessories.
## Installation
Install the plugin via the Homebridge UI. Before it can be used, the plugin configuration must be populated with your Hive `User Credentials` as well as the `Device Credentials` obtained via SMS two-factor authentication. To obtain the `Device Credentials`, do the following:
- From a terminal on your Homebridge machine, run `npx homebridge-hivehome-control`
- Follow the on-screen instructions. Enter your Hive `username` and `password`, then enter the 2FA code you receive via SMS.
- Once this is done, the script will show your `Device Group Key`, `Device Key` and `Device Password` credentials on screen.
- Copy these values exactly as they appear into the relevant fields of the plugin's configuration screen.
## Instructions
The plugin will expose a single `Heating Boost` switch for each Hive thermostat in your home. For each water heater, it will also create a `Hot Water` accessory containing two switches, `Manual` and `Boost`. The former will turn the hot water on until you turn it off, while the latter will boost it for a set period. Boost duration for both Heating and Hot Water, along with the target temperature for the former, can be set via the plugin's configuration.
## Requirements
The plugin requires `python3` and `pip3` to be installed on the system that Homebridge is running on. It will not attempt to install these packages itself.