@homebridge-plugins/homebridge-govee 11.25.0 → 11.26.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
+## 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/platform.js

@@ -654,6 +654,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 +723,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)
         }
       })

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.0",
   "description": "Homebridge plugin to integrate Govee devices into HomeKit.",
   "author": {
     "name": "bwp91",