Configuration

⚠️ It is recommended (and easier) to use the Homebridge/HOOBS UI plugin settings screen to configure the plugin

Required Settings

Add the following to your configuration file in the appropriate place. The following are the basic required fields.

{
   "name": "Govee",
   "username": "your-govee-email",
   "password": "your-govee-password",
   "platform": "Govee"
}

⚠️ The "platform": "Govee" line must not be changed

Optional Settings

Entry	Type	Default	Explanation
`refreshTime`	`integer`	`15`	An interval (in seconds) in which your cloud devices will refresh with Govee. Must be `15` or more.
`controlInterval`	`integer`	`500`	A minimum delay (in milliseconds) between cloud device updates being sent. Increasing this may help if you find device updates are not working or if you use HomeKit scenes/groupings. Must be `500` or more.
`disableDeviceLogging`	`bool`	`false`	Global logging setting for accessory status changes. If `true` then accessory status changes will not be logged. This can also be set per accessory later in the config.
`debug`	`bool`	`false`	Global logging setting for the plugin. If `true` then debug information will be added to the log. This can also be set per accessory later in the config.
`debugFakegato`	`bool`	`false`	If `true`, the included Fakegato library will debug to the log.
`disablePlugin`	`bool`	`false`	If `true`, the plugin will remove all accessories and not load the plugin on restart.
`lightDevices`	`array`	`[]`	An array of objects to define custom options for your Govee light devices. `label` - This setting has no effect except to help identify this device `deviceId` - Govee Device ID `ignoreDevice` - If `true`, this accessory will be removed and ignored from HomeKit `disableAWS` - If `true`, the plugin will disable the AWS connection for this device `enableBT` - If `true`, the plugin will try and control this device via bluetooth connection `brightnessStep` - A minimum step for the brightness slider in the Home app. Must be `1` or more `adaptiveLightingShift` - The mired for each Adaptive Lighting update will be increased by this value, making the light appear warmer. Set to `-1` to remove Adaptive Lighting feature. Must be `-1` or more `overrideLogging` - Override global logging setting for this device. Can be `default` (follows global setting), `standard` for standard logging, `debug` for debug logging or `disable` to disable accessory logging Example: "lightDevices": [ { "label": "TV LED Strip", "deviceId": "12:AB:A1:C5:A8:99:D2:17", "ignoreDevice": false, "enableBT": true, "brightnessStep": 10, "adaptiveLightingShift": 15, "overrideLogging": "default" } ]
`switchDevices`	`array`	`[]`	An array of objects to define custom options for your Govee switch devices. `label` - This setting has no effect except to help identify this device `deviceId` - Govee Device ID `ignoreDevice` - If `true`, this accessory will be removed and ignored from HomeKit `showAs` - Expose this device as an 'Outlet' (`default`), 'Switch' (`switch`) or 'Air Purifier' (`purifier`) `overrideLogging` - Override global logging setting for this device. Can be `default` (follows global setting), `standard` for standard logging, `debug` for debug logging or `disable` to disable accessory logging Example: "switchDevices": [ { "label": "Kitchen Lights", "deviceId": "12:AB:A1:C5:A8:99:D2:17", "ignoreDevice": false, "showAsType": "outlet", "overrideLogging": "debug" } ]
`leakDevices`	`array`	`[]`	An array of objects to define custom options for your Govee leak sensor devices. `label` - This setting has no effect except to help identify this device `deviceId` - Govee Device ID `ignoreDevice` - If `true`, this accessory will be removed and ignored from HomeKit `lowBattThreshold` - HomeKit will set the low battery status for this device when the battery reaches this percentage level. Must be `1` or more `overrideLogging` - Override global logging setting for this device. Can be `default` (follows global setting), `standard` for standard logging, `debug` for debug logging or `disable` to disable accessory logging Example: "leakDevices": [ { "label": "Bathroom Sensor", "deviceId": "12AB34CD56EF78009F", "ignoreDevice": false, "lowBattThreshold": 15, "overrideLogging": "default" } ]
`thermoDevices`	`array`	`[]`	An array of objects to define custom options for your Govee thermo-hygrometer devices. `label` - This setting has no effect except to help identify this device `deviceId` - Govee Device ID `ignoreDevice` - If `true`, this accessory will be removed and ignored from HomeKit `lowBattThreshold` - HomeKit will set the low battery status for this device when the battery reaches this percentage level. Must be `1` or more `overrideLogging` - Override global logging setting for this device. Can be `default` (follows global setting), `standard` for standard logging, `debug` for debug logging or `disable` to disable accessory logging Example: "thermoDevices": [ { "label": "Garden Sensor", "deviceId": "12:AB:A1:C5:A8:99:D2:17", "ignoreDevice": false, "lowBattThreshold": 20, "overrideLogging": "standard" } ]

Setup

Features

Help/About

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Configuration

Required Settings

Optional Settings

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Clone this wiki locally