homebridge-philips-airplus-cloud 0.3.5 → 0.3.6

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 The Home Assistant integration in `custom_components/` is unchanged from upstream and keeps its own history.
 
+## 0.3.6 — 2026-10-11
+
+- Components (Sleep, Air Quality, Filter, Pre-filter, Display) are no longer linked to the purifier by default. The Home app draws linked components as controls of the purifier without their names; unlinked ones get their own labelled tile in the purifier's combined view. Existing links are removed on startup. Set `linkComponents: true` to link them again.
+
 ## 0.3.5 — 2026-10-11
 
 - Option `labelRefresh`: if the Home app does not show the labels under the purifier's components in its combined view, set any new value and restart. About 40 s after startup the plugin renames the components in two steps (long name, then short label), replaying the rename that made Home show the labels before. Names set in the Home app are replaced by the defaults.

package/README.md

@@ -80,6 +80,7 @@ The refresh token rotates on every use; the plugin keeps the current one in `<ho
 | `filterSensors` | `true` | Show filter and pre-filter status |
 | `sleepSwitch` | `true` | Show the Sleep mode switch |
 | `sleepSwitchStyle` | `switch` | `purifier` shows the Sleep control as a second air purifier (purifier icon in Home) that only turns Sleep on/off |
+| `linkComponents` | `false` | Link Sleep, air quality and filters to the purifier. Off: each gets its own labelled tile in the purifier's combined view. On: Home shows them as controls inside the purifier, without labels |
 | `displayLight` | `true` | Show the display light |
 | `displayLightProperty` | — | Property key of the display light, if it is not detected (see the `Status properties reported by the device` log line) |
 | `logDeviceData` | `false` | Diagnostics: at startup, log every port and the cloud shadow the purifier publishes |

package/config.schema.json

@@ -91,6 +91,12 @@
         ],
         "description": "'Air purifier' shows Sleep with the purifier icon in the Home app; it only turns Sleep mode on and off."
       },
+      "linkComponents": {
+        "title": "Link components to the purifier",
+        "type": "boolean",
+        "default": false,
+        "description": "Off (default): Sleep, air quality and filters get their own labelled tile in the purifier's combined view. On: the Home app shows them as controls inside the purifier, without labels."
+      },
       "displayLight": {
         "title": "Show the display light as a dimmable light",
         "type": "boolean",
@@ -173,6 +179,7 @@
         "filterSensors",
         "sleepSwitch",
         "sleepSwitchStyle",
+        "linkComponents",
         "displayLight",
         "displayLightProperty",
         "filterChangeThreshold",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-philips-airplus-cloud",
   "displayName": "Philips Air+",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Homebridge plugin for Philips Air+ / PureProtect air purifiers via the Philips (Versuni) cloud — the same MQTT protocol used by the Air+ app and Google Home.",
   "main": "src/index.js",
   "license": "MIT",

package/src/accessory.js

@@ -238,8 +238,14 @@ class PurifierAccessory {
         s.setCharacteristic(Characteristic.ConfiguredName, label);
       }
     }
-    if (link && this.purifier && s !== this.purifier && !this.purifier.linkedServices.includes(s)) {
-      this.purifier.addLinkedService(s);
+    // linkComponents (default off): linked components are drawn by the Home
+    // app as controls of the purifier, without their names; unlinked ones get
+    // their own labelled tile in the purifier's combined view.
+    if (this.purifier && s !== this.purifier) {
+      const linked = this.purifier.linkedServices.includes(s);
+      const want = link && this.platform.config.linkComponents === true;
+      if (want && !linked) this.purifier.addLinkedService(s);
+      if (!want && linked) this.purifier.removeLinkedService(s);
     }
     return s;
   }