@homebridge-plugins/homebridge-govee 11.27.1-beta.0 → 11.27.1

package/CHANGELOG.md

@@ -2,10 +2,16 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
-## v11.27.1 (Pending Release)
+## v11.27.1 (2026-07-15)
 
-### Changes
+### Changed
 
+- fix: do not treat lights controllable via the openapi as bluetooth only (#1263) (@methodicallychaotic)
+- fix: do not initialise matter-ignored devices found on the lan (#1315)
+- fix: never pass external accessories to the homebridge cache so saving no longer fails
+- chore: remove the looking-for-maintainers message
+- fix: restore the online status update helper for thermo and leak sensors (#1317)
+- fix: skip app device groups found in the http device list (#1317)
 - fix: only treat fresh real-time gateway records as leak events, not periodic sync records (#1314)
 
 ## v11.27.0 (2026-07-13)

package/README.md

@@ -24,8 +24,6 @@ Homebridge plugin to integrate Govee devices into HomeKit
   - can control certain models locally via LAN control without any Govee credentials
   - may use different connection methods depending on device model and account capabilities
 
-> I'm looking for some lovely people to help maintain this plugin, please get in touch on GitHub or Discord if you'd like to help out 😄
-
 ### Prerequisites
 
 - To use this plugin, you will need to already have:

package/lib/device/light.js

@@ -27,7 +27,7 @@ export default class {
     this.colourSafeMode = platform.config.colourSafeMode
     this.minKelvin = accessory.context?.supportedCmdsOpts?.colorTem?.range?.min || 2000
     this.maxKelvin = accessory.context?.supportedCmdsOpts?.colorTem?.range?.max || 9000
-    this.isBLEOnly = !accessory.context.useAwsControl && !accessory.context.useLanControl
+    this.isBLEOnly = !accessory.context.useAwsControl && !accessory.context.useLanControl && !accessory.context.useOpenApiControl
 
     // Set up custom variables for this device type
     const deviceConf = platform.deviceConf[accessory.context.gvDeviceId] || {}

package/lib/platform.js

@@ -600,6 +600,12 @@ export default class {
             return
           }
 
+          // Skip Govee app device groups as these are not real devices (#1309)
+          if (['BaseGroup', 'SameModeGroup'].includes(httpDevice.sku)) {
+            this.log.debug('[%s] %s.', httpDevice.deviceName, platformLang.devIsGroup)
+            return
+          }
+
           // Check it's not a matter-ignored device, if the config has been set
           if (platformConsts.matterModels.includes(httpDevice.sku) && this.config.ignoreMatter) {
             return
@@ -705,6 +711,14 @@ export default class {
             return
           }
 
+          // Check it's not a matter-ignored device, if the config has been set, since a
+          // device skipped by the http/openapi loops for this reason still has an
+          // unmatched lan record, which would otherwise be added here and then removed
+          // again by the cleanup below on every restart (#1315)
+          if (this.config.ignoreMatter && platformConsts.matterModels.includes(lanDevice.sku)) {
+            return
+          }
+
           // Initialise the device into Homebridge
           // Since LAN does not provide a name, we will use the configured label or device id
           this.initialiseDevice({
@@ -874,7 +888,7 @@ export default class {
       this.logConnectionSummary()
 
       // Setup successful
-      this.log('%s. %s', platformLang.complete, platformLang.welcome)
+      this.log('%s.', platformLang.complete)
     } catch (err) {
       // Catch any errors during setup
       this.log.warn('***** %s [v%s]. *****', platformLang.disabling, plugin.version)
@@ -1415,7 +1429,9 @@ export default class {
       )
 
       // Update any changes to the accessory to the platform
-      this.api.updatePlatformAccessories([accessory])
+      if (!accessory.context.isExternal) {
+        this.api.updatePlatformAccessories([accessory])
+      }
       devicesInHB.set(accessory.UUID, accessory)
     } catch (err) {
       // Catch any errors during device initialisation
@@ -1650,6 +1666,12 @@ export default class {
         .setCharacteristic(this.api.hap.Characteristic.Model, device.model)
         .setCharacteristic(this.api.hap.Characteristic.Identify, true)
 
+      // Mark the accessory as external so it is never passed to
+      // updatePlatformAccessories, since Homebridge 2 adds any accessory passed
+      // there to its cached list, and an external accessory has no associated
+      // platform so every cache save then fails to serialize it
+      accessory.context.isExternal = true
+
       // Register the accessory
       this.api.publishExternalAccessories(plugin.name, [accessory])
       this.log('[%s] %s.', device.name, platformLang.devAdd)
@@ -1679,6 +1701,24 @@ export default class {
     devicesInHB.set(accessory.UUID, accessory)
   }
 
+  updateAccessoryStatus(accessory, newStatus) {
+    // Log the change, at a warning level if the device is reported offline
+    if (newStatus) {
+      accessory.log(platformLang.onlineHTTP)
+    } else {
+      accessory.logWarn(platformLang.offlineHTTP)
+    }
+
+    // Update the context item for the plugin UI
+    accessory.context.isOnline = newStatus ? 'yes' : 'no'
+
+    // Update any changes to the accessory to the platform
+    if (!accessory.context.isExternal) {
+      this.api.updatePlatformAccessories([accessory])
+    }
+    devicesInHB.set(accessory.UUID, accessory)
+  }
+
   removeAccessory(accessory) {
     // Remove an accessory from Homebridge
     try {
@@ -1793,7 +1833,9 @@ export default class {
         }
 
         if (update) {
-          this.api.updatePlatformAccessories([accessory])
+          if (!accessory.context.isExternal) {
+            this.api.updatePlatformAccessories([accessory])
+          }
           devicesInHB.set(accessory.UUID, accessory)
         }
 

package/lib/utils/lang-en.js

@@ -121,6 +121,8 @@ export default {
   twoFACodeInvalid: '2FA verification code was provided but login still failed - please check the code is correct and has not expired',
   noTokenExists: 'no account token has been retrieved',
   offlineBTConn: 'has been reported [disconnected] via BLE',
+  offlineHTTP: 'has been reported [offline]',
+  onlineHTTP: 'has been reported [online]',
   pluginNotConf: 'Plugin has not been configured',
   receivingUpdate: 'receiving update',
   sendingUpdate: 'sending update',
@@ -129,6 +131,5 @@ export default {
   storageWriteErr: 'could not save accessory to file as',
   syncFail: 'sync failed as',
   viaAL: 'via adaptive lighting',
-  welcome: 'I\'m looking for some lovely people to help maintain this plugin, please get in touch on GitHub or Discord if you\'d like to help out 😄',
   unknownCommand: 'unknown command in payload received',
 }

package/package.json

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