Govee-bt-client NPM

Govee H5xxx Bluetooth Client

A library to listen for the BLE (Bluetooth Low Energy) broadcasts from Govee Thermometer Hygrometer devices. Requires a compatible bluetooth module and operating system (see prepequisites).

Supported devices:

H5072
H5074
H5075
H5100
H5101
H5102
H5179

Installation

npm install govee-bt-client

API

startDiscovery: (callback: (reading: GoveeReading) => void)
- Starts listening to broadcasts and pass decrypted data into the callback function.
stopDiscovery()
- Stops listening to broadcasts from Bluetooth
debug: (on: boolean)
- Function to enable debugging of bluetooth advertisements and peripherals.

Example

import { startDiscovery, stopDiscovery, debug } from "./index";

debug(true);

console.log("=== start discovery");

startDiscovery((reading) => {
    console.log(reading);
});

setTimeout(async () => {
    await stopDiscovery();
    console.log("=== stop discovery");
}, 30000);

Credits

Credits and thanks to

Thrilleratplay/GoveeWatcher for explanation and examples of how to decode advertisement data for Govee H5075.
Home-Is-Where-You-Hang-Your-Hack/sensor.goveetemp_bt_hci for explanation and examples of advertisement data for various Govee devices.
@abandonware/noble for a great BLE library for node.
andrewjbates and eharris for triaging and developing an algorithm to parse H5075 data below 0 degrees Celsius.