@homebridge-plugins/homebridge-govee 11.25.0 → 11.26.1-beta.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
+## v11.26.1 (Pending Release)
+
+### Changes
+
+- fix: report leak events relayed by a wifi gateway over AWS (#1276)
+
+## v11.26.0 (2026-07-12)
+
+### Changes
+
+- feat: add support for the H609D Galaxy Light Projector (#1298)
+- fix: never remove accessories based on a failed device fetch (#1264)
+- fix: skip Govee app device groups from the OpenAPI device list (#1309)
+- feat: add under-construction support for the H1370 fan (#1307)
+- fix: use the segment-based BLE colour command for the H617E (#1290)
+- fix: send the on command first so scenes from off apply their colour (#1277)
+
 ## v11.25.0 (2026-07-12)
 
 ### Changes

package/lib/device/light.js

@@ -250,8 +250,13 @@ export default class {
         return
       }
 
-      // Await slightly longer than brightness and colour so on/off is sent last
-      await sleep(400)
+      // Send off after colour/brightness (a colour command can implicitly power a
+      // bulb back on), but send on straight away so the bulb is awake in time to
+      // receive the colour and brightness a HomeKit scene sends alongside it, as
+      // some models ignore these commands while switched off (#1277)
+      if (newValue === 'off') {
+        await sleep(400)
+      }
 
       // Send the request to the platform sender function
       await this.platform.sendDeviceUpdate(this.accessory, {
@@ -316,9 +321,11 @@ export default class {
   async internalBrightnessUpdate(value) {
     try {
       // This acts like a debounce function when endlessly sliding the brightness scale
+      // If the light is off (e.g. a HomeKit scene turning it on), wait longer so the
+      // on command sent by internalStateUpdate has time to wake the bulb first (#1277)
       const updateKeyBright = generateRandomString(5)
       this.updateKeyBright = updateKeyBright
-      await sleep(350)
+      await sleep(this.cacheState !== 'on' ? 1050 : 350)
       if (updateKeyBright !== this.updateKeyBright) {
         return
       }
@@ -367,9 +374,11 @@ export default class {
   async internalColourUpdate(value, force = false) {
     try {
       // This acts like a debounce function when endlessly sliding the colour wheel
+      // If the light is off (e.g. a HomeKit scene turning it on), wait longer so the
+      // on command sent by internalStateUpdate has time to wake the bulb first (#1277)
       const updateKeyColour = generateRandomString(5)
       this.updateKeyColour = updateKeyColour
-      await sleep(300)
+      await sleep(this.cacheState !== 'on' ? 1000 : 300)
       if (updateKeyColour !== this.updateKeyColour) {
         return
       }
@@ -440,9 +449,12 @@ export default class {
   async internalCTUpdate(value) {
     try {
       // This acts like a debounce function when endlessly sliding the colour wheel
+      // If the light is off (e.g. a HomeKit scene turning it on), wait longer so the
+      // on command sent by internalStateUpdate has time to wake the bulb first, and
+      // so the 'skip when off' check below sees the updated state (#1277)
       const updateKeyCT = generateRandomString(5)
       this.updateKeyCT = updateKeyCT
-      await sleep(300)
+      await sleep(this.cacheState !== 'on' ? 1000 : 300)
       if (updateKeyCT !== this.updateKeyCT) {
         return
       }

package/lib/device/sensor-leak.js

@@ -67,7 +67,7 @@ export default class {
     }
 
     // Check to see if the provided leak status is different from the cached state
-    if (params.leakDetected !== this.cacheLeak) {
+    if (hasProperty(params, 'leakDetected') && params.leakDetected !== this.cacheLeak) {
       // Leak status is different so update Homebridge with new values
       this.cacheLeak = params.leakDetected
       this.service.updateCharacteristic(this.hapChar.LeakDetected, this.cacheLeak ? 1 : 0)

package/lib/platform.js

@@ -19,6 +19,7 @@ import platformChars from './utils/custom-chars.js'
 import { getDeviceCapabilities } from './utils/device-capabilities.js'
 import eveChars from './utils/eve-chars.js'
 import {
+  base64ToHex,
   hasProperty,
   parseDeviceId,
   parseError,
@@ -654,6 +655,12 @@ export default class {
 
       if (openApiDevices && openApiDevices.length > 0) {
         openApiDevices.forEach((openApiDevice) => {
+          // Skip Govee app device groups as these are not real devices (#1309)
+          if (['BaseGroup', 'SameModeGroup'].includes(openApiDevice.model)) {
+            this.log.debug('[%s] %s.', openApiDevice.deviceName, platformLang.devIsGroup)
+            return
+          }
+
           if (this.ignoredDevices.includes(openApiDevice.device)) {
             return
           }
@@ -717,18 +724,28 @@ export default class {
       }
 
       // Check for redundant Homebridge accessories
+      // Only treat 'not found in Govee' as a reason to remove an accessory when the
+      // configured cloud clients actually returned their device lists this session,
+      // otherwise a failed fetch would remove the accessory and destroy any HomeKit
+      // scenes and automations it is part of (#1264)
+      const cloudListsFetched = (!this.config.username || !!this.httpClient)
+        && (!!this.config.openApiDisable || !this.config.apiKey || !!this.openApiClient)
       devicesInHB.forEach((accessory) => {
-        // If the accessory doesn't exist in Govee then remove it. Also remove it
-        // if it is now being ignored, or if it is a matter model and the user has
-        // enabled ignoreMatter (otherwise the cached accessory lingers even though
-        // the device is skipped during setup) (#1287).
-        if (
-          (!httpDevices.some(el => el.device === accessory.context.gvDeviceId)
-            && !lanDevices.some(el => el.device === accessory.context.gvDeviceId)
-            && !openApiDevices.some(el => el.device === accessory.context.gvDeviceId))
-          || this.ignoredDevices.includes(accessory.context.gvDeviceId)
+        // Remove the accessory if it is now being ignored, or if it is a matter model
+        // and the user has enabled ignoreMatter (otherwise the cached accessory lingers
+        // even though the device is skipped during setup) (#1287)
+        const isIgnored = this.ignoredDevices.includes(accessory.context.gvDeviceId)
           || (this.config.ignoreMatter && platformConsts.matterModels.includes(accessory.context.gvModel))
-        ) {
+
+        // Also remove it if the device no longer exists in Govee, but never based on
+        // an incomplete cloud list, and never for LAN-only devices which may simply
+        // have missed a scan window (#1264)
+        const isMissing = !httpDevices.some(el => el.device === accessory.context.gvDeviceId)
+          && !lanDevices.some(el => el.device === accessory.context.gvDeviceId)
+          && !openApiDevices.some(el => el.device === accessory.context.gvDeviceId)
+        const isLanOnly = accessory.context.hasLanControl && !accessory.context.firmware
+
+        if (isIgnored || (isMissing && cloudListsFetched && !isLanOnly)) {
           this.removeAccessory(accessory)
         }
       })
@@ -1356,6 +1373,14 @@ export default class {
               }
             }
 
+            // Gateway subdevices (e.g. leak sensors paired to an H5044) include
+            // their gateway id and slot number, which we need to match real-time
+            // leak events relayed by the gateway over AWS (#1276)
+            if (hasProperty(parsed, 'sno') && parsed.gatewayInfo?.device) {
+              accessory.context.gatewaySno = parsed.sno
+              accessory.context.gatewayDevice = parsed.gatewayInfo.device
+            }
+
             // Get a min and max temperature/humidity range to show in the homebridge-ui
             if (hasProperty(parsed, 'temCali')) {
               accessory.context.minTemp = parsed.temMin / 100
@@ -1506,6 +1531,13 @@ export default class {
           if (platformConsts.models.sensorLeak.includes(device1.sku)) {
             accessory.logDebug(`raw data: ${JSON.stringify({ ...parsedData, ...parsedSettings })}`)
 
+            // Keep the gateway details up to date for matching real-time leak
+            // events relayed by the gateway over AWS (#1276)
+            if (hasProperty(parsedSettings, 'sno') && parsedSettings.gatewayInfo?.device) {
+              accessory.context.gatewaySno = parsedSettings.sno
+              accessory.context.gatewayDevice = parsedSettings.gatewayInfo.device
+            }
+
             // Leak Sensors - check to see of any warnings if the lastTime is above 0
             let hasUnreadLeak = false
             if (parsedData.lastTime > 0) {
@@ -1789,9 +1821,46 @@ export default class {
   receiveUpdateAWS(payload) {
     const accessoryUUID = this.api.hap.uuid.generate(payload.device)
     const accessory = devicesInHB.get(accessoryUUID)
-    this.receiveDeviceUpdate(accessory, {
-      source: 'AWS',
-      ...payload,
+    if (accessory) {
+      this.receiveDeviceUpdate(accessory, {
+        source: 'AWS',
+        ...payload,
+      })
+      return
+    }
+
+    // No matching accessory - the message may be from a wifi gateway (e.g. H5044)
+    // relaying an update for one of its subdevices, such as a leak sensor (#1276)
+    this.receiveUpdateAWSGateway(payload)
+  }
+
+  receiveUpdateAWSGateway(payload) {
+    (payload?.op?.command || []).forEach((command) => {
+      let hexString
+      try {
+        hexString = base64ToHex(command)
+      } catch {
+        return
+      }
+
+      // 0xEE34 is a gateway subdevice status, laid out as:
+      // ee 34 [subdevice number] 02 00 64 1e 14 [seq] [unix time x4] [leak flags x4] 80 00 [checksum]
+      if (!hexString.startsWith('ee34') || hexString.length < 36) {
+        return
+      }
+      const subdeviceNo = Number.parseInt(hexString.substring(4, 6), 16)
+      const leakDetected = hexString.substring(26, 34) !== '00000000'
+
+      // Match the update to the leak sensor with this gateway and slot number
+      devicesInHB.forEach((accessory) => {
+        if (
+          accessory.context.gatewayDevice === payload.device
+          && accessory.context.gatewaySno === subdeviceNo
+          && platformConsts.models.sensorLeak.includes(accessory.context.gvModel)
+        ) {
+          this.receiveDeviceUpdate(accessory, { source: 'AWS', leakDetected })
+        }
+      })
     })
   }
 

package/lib/utils/constants.js

@@ -219,6 +219,7 @@ export default {
       'H6097',
       'H6098',
       'H6099',
+      'H609D',
       'H60A0',
       'H60A1',
       'H60A4',
@@ -542,6 +543,7 @@ export default {
     kettle: ['H7170', 'H7171', 'H7173', 'H7175', 'H717A'],
     template: [
       'H1162', // https://github.com/homebridge-plugins/homebridge-govee/issues/422
+      'H1370', // https://github.com/homebridge-plugins/homebridge-govee/issues/1307
       'H1167', // https://github.com/homebridge-plugins/homebridge-govee/issues/1142
       'H5010', // https://github.com/homebridge-plugins/homebridge-govee/issues/1235
       'H5024', // https://github.com/homebridge-plugins/homebridge-govee/issues/835

package/lib/utils/device-capabilities.js

@@ -14,12 +14,14 @@ const modelOverrides = {
   H6102: { bleColorCmd: [COLOR_SUB.RGB_ALT], bleBrightnessScale: 0x64 },
   H613B: { bleColorCmd: [COLOR_SUB.RGB_ALT], bleBrightnessScale: 0x64 },
   H613D: { bleColorCmd: [COLOR_SUB.RGB_ALT], bleBrightnessScale: 0x64 },
-  H617E: { bleColorCmd: [COLOR_SUB.RGB_ALT], bleBrightnessScale: 0x64 },
 
   // BLE color sub-command: 0x15 0x01 (extended) with trailing bytes
   H6053: { bleColorCmd: COLOR_SUB.RGB_EXTENDED, bleColorCmdSuffix: [0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x7F] },
   H6072: { bleColorCmd: COLOR_SUB.RGB_EXTENDED, bleColorCmdSuffix: [0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x7F] },
   H6199: { bleColorCmd: COLOR_SUB.RGB_EXTENDED, bleColorCmdSuffix: [0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x7F] },
+  // H617E is an RGBIC strip which ignores the 0x0D command - it needs the
+  // segment-based extended format, as seen in its own TTR rule data (#1290)
+  H617E: { bleColorCmd: COLOR_SUB.RGB_EXTENDED, bleColorCmdSuffix: [0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x7F], bleBrightnessScale: 0x64 },
 
   // AWS outlet uses 17/16 for on/off instead of 1/0
   H5080: { awsPowerOn: 17, awsPowerOff: 16 },

package/lib/utils/lang-en.js

@@ -68,6 +68,7 @@ export default {
   curWatt: 'current wattage',
   devAdd: 'has been added to Homebridge',
   devInit: 'initialised with id',
+  devIsGroup: 'is a Govee app device group so will not be added to Homebridge',
   devInitOpts: 'initialising with options',
   devMaySupp: 'is not currently supported, do create a Github issue with the following info',
   devNoBlePackage: 'will not be added as BLE is disabled in the config',

package/package.json

@@ -2,7 +2,7 @@
   "name": "@homebridge-plugins/homebridge-govee",
   "alias": "Govee",
   "type": "module",
-  "version": "11.25.0",
+  "version": "11.26.1-beta.0",
   "description": "Homebridge plugin to integrate Govee devices into HomeKit.",
   "author": {
     "name": "bwp91",