@homebridge-plugins/homebridge-govee 11.30.0-beta.2 → 11.30.0-beta.3

package/CHANGELOG.md

@@ -9,6 +9,7 @@ All notable changes to `@homebridge-plugins/homebridge-govee` will be documented
 - chore(ble): let noble apply its own adapter timeout instead of racing a second one
 - fix: restore aws brightness scaling, so lights reach the brightness asked for (#1262) (@gradyg21)
 - fix: skip a periodic sync when the previous one is still running, so slow responses stop stacking up (#1256) (@schwaggy)
+- fix: work out whether the openapi sensor temperature is celsius or fahrenheit, so thermometers no longer read too high (#1269) (@tdporter)
 
 ## v11.29.3 (2026-07-21)
 

package/config.schema.json

@@ -1143,6 +1143,35 @@
                 "functionBody": "return (model.thermoDevices && model.thermoDevices[arrayIndices] && model.thermoDevices[arrayIndices].deviceId && [23,26].includes(model.thermoDevices[arrayIndices].deviceId.length) && !model.thermoDevices[arrayIndices].ignoreDevice);"
               }
             },
+            "openApiTempUnit": {
+              "type": "string",
+              "title": "OpenAPI Temperature Unit",
+              "description": "Govee's OpenAPI reports the temperature in whatever unit your Govee app is set to, without saying which. Leave this on Auto and the plugin will work it out. Only set it manually if the reported temperature is wrong.",
+              "default": "auto",
+              "oneOf": [
+                {
+                  "title": "Auto (Recommended)",
+                  "enum": [
+                    "auto"
+                  ]
+                },
+                {
+                  "title": "Celsius",
+                  "enum": [
+                    "c"
+                  ]
+                },
+                {
+                  "title": "Fahrenheit",
+                  "enum": [
+                    "f"
+                  ]
+                }
+              ],
+              "condition": {
+                "functionBody": "return (model.thermoDevices && model.thermoDevices[arrayIndices] && model.thermoDevices[arrayIndices].deviceId && [23,26].includes(model.thermoDevices[arrayIndices].deviceId.length) && !model.thermoDevices[arrayIndices].ignoreDevice);"
+              }
+            },
             "showExtraSwitch": {
               "type": "boolean",
               "title": "Show Extra Switch",
@@ -1625,6 +1654,7 @@
             "thermoDevices[].deviceId",
             "thermoDevices[].ignoreDevice",
             "thermoDevices[].lowBattThreshold",
+            "thermoDevices[].openApiTempUnit",
             "thermoDevices[].showExtraSwitch"
           ]
         }

package/lib/platform.js

@@ -236,6 +236,7 @@ export default class {
                     this.deviceConf[id][k] = v === 'false' ? false : !!v
                     break
                   case 'awsColourMode':
+                  case 'openApiTempUnit':
                   case 'showAs': {
                     if (typeof v !== 'string' || !platformConsts.allowed[k].includes(v)) {
                       logIgnore(`${key}.${id}.${k}`)
@@ -1291,6 +1292,13 @@ export default class {
         accessory.context.temperatureSource = deviceConf.temperatureSource
       }
 
+      // Add the openApiTempUnit config to the context if set to something other than auto
+      if (deviceConf.openApiTempUnit && deviceConf.openApiTempUnit !== 'auto') {
+        accessory.context.openApiTempUnit = deviceConf.openApiTempUnit
+      } else {
+        delete accessory.context.openApiTempUnit
+      }
+
       // Get a supported command list if provided, with their options
       if (device.supportCmds && Array.isArray(device.supportCmds)) {
         accessory.context.supportedCmds = device.supportCmds
@@ -1969,6 +1977,12 @@ export default class {
       delete data.kelvinOutOfRange
     }
 
+    // Skip the reading if we can't tell whether govee sent celsius or fahrenheit
+    if (data.temperatureUnitUnknown) {
+      accessory.logDebugWarn(platformLang.openApiTempUnitUnknown)
+      delete data.temperatureUnitUnknown
+    }
+
     // Check if we actually parsed anything useful (more than just the source property)
     if (Object.keys(data).length > 1) {
       try {

package/lib/utils/constants.js

@@ -92,7 +92,7 @@ export default {
       'temperatureSource',
     ],
     leakDevices: ['label', 'deviceId', 'ignoreDevice', 'lowBattThreshold'],
-    thermoDevices: ['label', 'deviceId', 'ignoreDevice', 'lowBattThreshold', 'showExtraSwitch'],
+    thermoDevices: ['label', 'deviceId', 'ignoreDevice', 'lowBattThreshold', 'openApiTempUnit', 'showExtraSwitch'],
     fanDevices: ['label', 'deviceId', 'ignoreDevice', 'hideLight'],
     heaterDevices: ['label', 'deviceId', 'ignoreDevice', 'tempReporting'],
     humidifierDevices: ['label', 'deviceId', 'ignoreDevice'],
@@ -112,6 +112,7 @@ export default {
     ],
     iceMakerDevices: ['label', 'deviceId', 'ignoreDevice'],
     awsColourMode: ['default', 'rgb', 'redgreenblue'],
+    openApiTempUnit: ['auto', 'c', 'f'],
     showAs: [
       'default',
       'audio',

package/lib/utils/lang-en.js

@@ -17,6 +17,7 @@ export default {
   available: 'client enabled',
   availableWithDevices: n => `client enabled and found ${n} device(s)`,
   openApiNoKey: 'api key not provided',
+  openApiTempUnitUnknown: 'ignoring the openapi temperature as it is unclear whether govee sent celsius or fahrenheit - you can set this in the plugin settings for this device',
   brand: 'Govee',
   bleNonControl: 'will be visible but uncontrollable as BLE not available',
   bleNoPackage: 'required hardware/packages not available',

package/lib/utils/response-parser.js

@@ -2,6 +2,50 @@ import platformConsts from './constants.js'
 
 const hasProperty = (obj, prop) => Object.hasOwn(obj, prop)
 
+/**
+ * Works out which unit an OpenAPI `sensorTemperature` value is in.
+ *
+ * Govee's OpenAPI reports this value in whatever unit the Govee app is set to, and
+ * sends no unit alongside it. The HTTP API always reports hundredths of a degree
+ * Celsius, so where a device has both we can compare the two and see which fits.
+ *
+ * @param {number} value - The raw OpenAPI sensorTemperature value
+ * @param {object} context - Accessory context
+ * @returns {'c'|'f'|null} The unit, or null if it cannot be determined
+ */
+function resolveOpenApiTempUnit(value, context) {
+  // An explicit setting always wins
+  if (context.openApiTempUnit === 'c' || context.openApiTempUnit === 'f') {
+    return context.openApiTempUnit
+  }
+
+  // Govee may declare the unit on the capability itself
+  const declared = context.openApiCapabilities?.sensorTemperature?.parameters?.unit
+  if (typeof declared === 'string') {
+    if (declared.toLowerCase().startsWith('f')) {
+      return 'f'
+    }
+    if (declared.toLowerCase().startsWith('c')) {
+      return 'c'
+    }
+  }
+
+  // Otherwise compare against the last HTTP reading, which is always Celsius
+  const reference = context.lastHttpTempCelsius
+  if (typeof reference === 'number') {
+    const asCelsius = Math.abs(value - reference)
+    const asFahrenheit = Math.abs(((value - 32) * 5) / 9 - reference)
+    if (asFahrenheit + 0.5 < asCelsius) {
+      return 'f'
+    }
+    if (asCelsius + 0.5 < asFahrenheit) {
+      return 'c'
+    }
+  }
+
+  return null
+}
+
 /**
  * Parses a raw device update payload into a standardised data object.
  * Handles different payload structures from AWS, LAN, OpenAPI, and legacy devices.
@@ -97,6 +141,11 @@ export function parseDeviceUpdate(params, context) {
   // CURRENT TEMPERATURE
   if (hasProperty(params, 'temperature')) {
     data.temperature = params.temperature
+
+    // The HTTP value is always Celsius, so keep it as a reference for the OpenAPI value
+    if (params.source === 'HTTP' && Number.isFinite(params.temperature)) {
+      context.lastHttpTempCelsius = params.temperature / 100
+    }
   } else if (params?.state?.sta && hasProperty(params.state.sta, 'curTem')) {
     data.temperature = params.state.sta.curTem
   }
@@ -136,7 +185,16 @@ export function parseDeviceUpdate(params, context) {
 
   // SENSOR TEMPERATURE (OpenAPI property)
   if (params.state && hasProperty(params.state, 'sensorTemperature')) {
-    data.temperature = params.state.sensorTemperature * 100
+    const sensorTemp = Number(params.state.sensorTemperature)
+    const unit = resolveOpenApiTempUnit(sensorTemp, context)
+    if (unit === 'f') {
+      data.temperature = Math.round((((sensorTemp - 32) * 5) / 9) * 100)
+    } else if (unit === 'c') {
+      data.temperature = Math.round(sensorTemp * 100)
+    } else {
+      // Unit unknown, so report nothing rather than a wrong reading
+      data.temperatureUnitUnknown = true
+    }
   }
 
   // SENSOR HUMIDITY (OpenAPI property)

package/package.json

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