homebridge-bluos 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.1.2](https://github.com/tbaur/homebridge-bluos/compare/v1.1.1...v1.1.2) (2026-08-30)
+
+
+### Bug Fixes
+
+* do not end the reboot quiet window on a last-gasp poll ([#26](https://github.com/tbaur/homebridge-bluos/issues/26)) ([91651a4](https://github.com/tbaur/homebridge-bluos/commit/91651a4c4b114c8a8e7bfba0cc7c4d6148375b7d))
+
+## [1.1.1](https://github.com/tbaur/homebridge-bluos/compare/v1.1.0...v1.1.1) (2026-08-30)
+
+
+### Bug Fixes
+
+* keep accessories quiet while a rebooted player comes back ([#24](https://github.com/tbaur/homebridge-bluos/issues/24)) ([dc4f792](https://github.com/tbaur/homebridge-bluos/commit/dc4f7921cb584697e5e49f92ec0207642d88a541))
+
 ## [1.1.0](https://github.com/tbaur/homebridge-bluos/compare/v1.0.3...v1.1.0) (2026-08-30)
 
 

package/README.md

@@ -14,13 +14,13 @@ Browsing, search, queues and artwork stay in the BluOS app, which HomeKit cannot
 - **Mute switch:** unmuting restores the level the player remembered, not a guess
 - **Volume presets:** one switch per exact level, addressable by name with Siri
 - **Battery sensor:** level, charging state and low-battery warning, for players with a battery pack
-- **Reboot switch:** momentary, so a scene cannot restart your stereo, and still pressable when the player has stopped answering
+- **Reboot switch:** momentary, so a scene cannot reboot your stereo, and still pressable when the player has stopped answering
 - **Grouping-aware:** a zone leading a BluOS group moves the whole group, exactly as it does in the BluOS app
 - **Multi-zone chassis:** each zone of a NAD CI S2 or CI 580 is its own player, on its own port
 
 ### For the whole install
 
-- **Reboot all:** off by default. One switch that restarts every BluOS player it can find on the network, naming each one in the log first
+- **Reboot all:** off by default. One switch that reboots every BluOS player it can find on the network. The info log is a count (`found 2 device(s), 3 player(s)`); the debug log names each box
 
 ### Reliability
 
@@ -111,7 +111,7 @@ Only one `BluOS` platform block is supported. It can hold as many players as you
 | `devices` | ✓ | List of players |
 | `options.sliderService` | | `fan` (default) or `lightbulb`, for every slider |
 | `options.discoveryTimeoutSec` | | mDNS listening window, 1–30 seconds (default 5) |
-| `options.rebootAll` | | Expose one switch that restarts **every BluOS player on the network** (default false) |
+| `options.rebootAll` | | Expose one switch that reboots **every BluOS player on the network** (default false) |
 | `options.rebootAllName` | | What that switch is called in the Home app |
 
 Each entry in `devices[]` takes `id`, `name` and `host`, plus an optional `port`, `volumeSlider`, `sliderService`, `mute`, `battery`, `reboot` and `volumePresets[]`. The [detailed documentation](docs/README-DETAILED.md#devices-entries) describes each one, and explains which changes are safe to make to a working install.
@@ -121,7 +121,7 @@ Each entry in `devices[]` takes `id`, `name` and `host`, plus an optional `port`
 1. **Nothing found by Discover Players.** mDNS is often filtered across VLANs and by some access points. Use manual address entry, or add the player by hand
 2. **Everything shows No Response and stays that way.** Check the log for `BluOS is disabled until its configuration is fixed`
 3. **A zone on a multi-zone chassis is missing.** Check the port. Zone two is 11010, not 11000
-4. **A reboot switch restarted the room next door.** Expected on a multi-zone chassis. BluOS serves reboot per box, not per zone
+4. **A reboot switch rebooted the room next door.** Expected on a multi-zone chassis. BluOS serves reboot per box, not per zone
 5. **The reboot switch turns itself off.** By design. It is a button, not a state
 6. Restart Homebridge after editing `config.json` by hand
 

package/config.schema.json

@@ -42,7 +42,7 @@
             "title": "Reboot All Switch",
             "type": "boolean",
             "default": false,
-            "description": "One switch that restarts every BluOS player it can find. Its reach is the whole network, not just the players listed below: pressing it also restarts players you have deliberately left out of this configuration. Every player is named in the Homebridge log before anything is sent."
+            "description": "One switch that reboots every BluOS player it can find. Its reach is the whole network, not just the players listed below: pressing it also reboots players you have deliberately left out of this configuration. The info log is a count of devices and players; the debug log names each box before anything is sent."
           },
           "rebootAllName": {
             "title": "Reboot All Name",
@@ -125,7 +125,7 @@
               "title": "Reboot Switch",
               "type": "boolean",
               "default": false,
-              "description": "A switch that restarts this player. It springs back to off on its own and does nothing when switched off, so a scene or \"turn everything off\" cannot trigger it. Restarting interrupts playback. On a multi-zone chassis such as a CI S2 it restarts every zone on that box: BluOS reboots the box, not the zone, and there is no way to restart just this room."
+              "description": "A switch that reboots this player. It springs back to off on its own and does nothing when switched off, so a scene or \"turn everything off\" cannot trigger it. Rebooting interrupts playback. On a multi-zone chassis such as a CI S2 it reboots every zone on that box: BluOS reboots the box, not the zone, and there is no way to reboot just this room."
             },
             "volumePresets": {
               "title": "Volume Presets",

package/dist/devices/host.d.ts

@@ -74,4 +74,12 @@ export interface AccessoryHost {
      * loud rather than letting someone discover it.
      */
     playersSharingAddress(deviceId: string): readonly string[];
+    /**
+     * A reboot request has reached this address, so silence from it is expected.
+     *
+     * The poller will fail while the box is down. Calling this is what stops every
+     * accessory on that address from warning, and what makes the next successful
+     * poll the source of truth for HomeKit instead of the pre-reboot reading.
+     */
+    expectReboot(host: string): void;
 }

package/dist/devices/reboot-accessory.js

@@ -51,7 +51,7 @@ class RebootAccessory extends base_accessory_1.BaseAccessory {
             .onSet(async (value) => this.writeOn(value));
         const shared = this.host.playersSharingAddress(this.deviceId);
         if (shared.length > 0) {
-            this.host.log.warn(`${(0, utils_1.forLog)(this.displayName)} will also restart ${shared.map(utils_1.forLog).join(', ')}: `
+            this.host.log.warn(`${(0, utils_1.forLog)(this.displayName)}: will also reboot ${shared.map(utils_1.forLog).join(', ')}: `
                 + 'they are zones of one chassis, and BluOS reboots the whole box');
         }
     }
@@ -67,6 +67,9 @@ class RebootAccessory extends base_accessory_1.BaseAccessory {
                 }
                 // The host only: reboot lives on port 80, not on the zone's control port.
                 const result = await this.host.client.reboot(endpoint.host);
+                // The box is going down. Tell the platform so the other accessories
+                // stay quiet, and so the next poll is what HomeKit shows.
+                this.host.expectReboot(endpoint.host);
                 // Never a group operation. Grouping decides where a *volume* change
                 // reaches; a reboot restarts a box and has no notion of followers.
                 this.logAction(result.acknowledged ? 'REBOOT' : 'REBOOT (sent; the player stopped answering, as expected)', { tellSlaves: false });

package/dist/devices/reboot-all-accessory.d.ts

@@ -13,9 +13,10 @@
  *
  * Its reach is wider than the plugin's configuration: it restarts every player
  * mDNS answers for, including ones deliberately left out of `devices[]`. That is
- * what it is for, and it is why the option is off by default and why every target
- * is named in the log before a single request goes out. The BluOS API has no
- * authentication, so anything on the segment will comply.
+ * what it is for, and it is why the option is off by default. The info log is a
+ * count of devices and players; the debug log names every box before a single
+ * request goes out. The BluOS API has no authentication, so anything on the
+ * segment will comply.
  *
  * It works in addresses rather than players, because reboot is served on port 80
  * and port 80 is one server per chassis. A CI S2 carrying two zones is one
@@ -34,7 +35,7 @@ export declare class RebootAllAccessory extends BaseAccessory {
     private resetTimer;
     constructor(init: AccessoryInit);
     private writeOn;
-    /** Name everything that is about to go down, before any of it does. */
+    /** Count at info, name every box at debug, before any request goes out. */
     private announce;
     /**
      * Restart every target, letting each succeed or fail on its own.

package/dist/devices/reboot-all-accessory.js

@@ -14,9 +14,10 @@
  *
  * Its reach is wider than the plugin's configuration: it restarts every player
  * mDNS answers for, including ones deliberately left out of `devices[]`. That is
- * what it is for, and it is why the option is off by default and why every target
- * is named in the log before a single request goes out. The BluOS API has no
- * authentication, so anything on the segment will comply.
+ * what it is for, and it is why the option is off by default. The info log is a
+ * count of devices and players; the debug log names every box before a single
+ * request goes out. The BluOS API has no authentication, so anything on the
+ * segment will comply.
  *
  * It works in addresses rather than players, because reboot is served on port 80
  * and port 80 is one server per chassis. A CI S2 carrying two zones is one
@@ -54,7 +55,7 @@ class RebootAllAccessory extends base_accessory_1.BaseAccessory {
             await this.completeWithinBudget('reboot all', async () => {
                 const targets = await this.host.rebootTargets();
                 if (targets.length === 0) {
-                    this.host.log.warn(`${(0, utils_1.forLog)(this.displayName)} found nothing to restart. `
+                    this.host.log.warn(`${(0, utils_1.forLog)(this.displayName)}: found nothing to reboot. `
                         + 'Multicast may be filtered on this network and no players are configured');
                     return;
                 }
@@ -66,13 +67,14 @@ class RebootAllAccessory extends base_accessory_1.BaseAccessory {
             this.scheduleReset();
         }
     }
-    /** Name everything that is about to go down, before any of it does. */
+    /** Count at info, name every box at debug, before any request goes out. */
     announce(targets) {
+        const players = playerCount(targets);
+        this.host.log.info(`${(0, utils_1.forLog)(this.displayName)}: found ${targets.length} device(s), ${players} player(s)`);
         const listed = targets
             .map((target) => `${target.host} (${target.names.map(utils_1.forLog).join(', ')})`)
             .join('; ');
-        const players = targets.reduce((total, target) => total + target.names.length, 0);
-        this.host.log.info(`${(0, utils_1.forLog)(this.displayName)}: rebooting ${targets.length} box(es) carrying `
+        this.host.log.debug(`${(0, utils_1.forLog)(this.displayName)}: rebooting ${targets.length} box(es) carrying `
             + `${players} player(s): ${listed}`);
     }
     /**
@@ -89,15 +91,19 @@ class RebootAllAccessory extends base_accessory_1.BaseAccessory {
         let failed = 0;
         outcomes.forEach((outcome, index) => {
             const target = targets[index];
-            if (outcome.status === 'fulfilled' || target === undefined) {
+            if (target === undefined) {
+                return;
+            }
+            if (outcome.status === 'fulfilled') {
+                this.host.expectReboot(target.host);
                 return;
             }
             failed += 1;
-            this.host.log.warn(`${(0, utils_1.forLog)(this.displayName)} could not reboot ${target.host} `
+            this.host.log.warn(`${(0, utils_1.forLog)(this.displayName)}: could not reboot ${target.host} `
                 + `(${target.names.map(utils_1.forLog).join(', ')}): ${(0, utils_1.describeError)(outcome.reason)}`);
         });
-        const restarted = targets.length - failed;
-        this.host.log.info(`${(0, utils_1.forLog)(this.displayName)}: ${restarted} of ${targets.length} box(es) took the reboot`);
+        const rebooted = targets.length - failed;
+        this.host.log.info(`${(0, utils_1.forLog)(this.displayName)}: ${rebooted} of ${targets.length} device(s) rebooted`);
     }
     /** Spring the tile back to off, the way a real button returns. */
     scheduleReset() {
@@ -131,3 +137,7 @@ class RebootAllAccessory extends base_accessory_1.BaseAccessory {
     }
 }
 exports.RebootAllAccessory = RebootAllAccessory;
+/** How many player names sit behind the given boxes. */
+function playerCount(targets) {
+    return targets.reduce((total, target) => total + target.names.length, 0);
+}

package/dist/platform.d.ts

@@ -51,6 +51,8 @@ export declare class BluOSPlatform implements DynamicPlatformPlugin, AccessoryHo
     private readonly staggerTimers;
     /** The launch address sweep, tracked so a shutdown can wait for it to end. */
     private launchSweep;
+    /** Addresses we have just asked to reboot, while silence from them is expected. */
+    private readonly rebootGrace;
     constructor(log: Logging, config: PlatformConfig, api: API);
     get hap(): API['hap'];
     /** Homebridge hands back every accessory it restored from disk. */
@@ -98,6 +100,16 @@ export declare class BluOSPlatform implements DynamicPlatformPlugin, AccessoryHo
      * not asked to manage.
      */
     playersSharingAddress(deviceId: string): readonly string[];
+    /**
+     * A reboot request has reached this address.
+     *
+     * In-flight long-polls are dropped so the next reading is of the player after
+     * it comes back, not of the request that died with the box. Failures during
+     * the grace window do not mark accessories unreachable.
+     */
+    expectReboot(host: string): void;
+    /** Current address of a player, preferring the poller when it has one. */
+    private hostOf;
     private start;
     private stop;
     /**

package/dist/platform.js

@@ -58,6 +58,8 @@ class BluOSPlatform {
     staggerTimers = new Set();
     /** The launch address sweep, tracked so a shutdown can wait for it to end. */
     launchSweep;
+    /** Addresses we have just asked to reboot, while silence from them is expected. */
+    rebootGrace = new utils_1.RebootGrace(settings_1.REBOOT_GRACE_MS);
     constructor(log, config, api) {
         this.log = log;
         this.config = config;
@@ -198,6 +200,26 @@ class BluOSPlatform {
             && (this.endpointFor(device.id)?.host ?? device.host) === host)
             .map((device) => device.name);
     }
+    /**
+     * A reboot request has reached this address.
+     *
+     * In-flight long-polls are dropped so the next reading is of the player after
+     * it comes back, not of the request that died with the box. Failures during
+     * the grace window do not mark accessories unreachable.
+     */
+    expectReboot(host) {
+        this.rebootGrace.expect(host);
+        for (const [deviceId, poller] of this.pollers) {
+            if (this.hostOf(deviceId) === host) {
+                poller.refreshNow();
+            }
+        }
+    }
+    /** Current address of a player, preferring the poller when it has one. */
+    hostOf(deviceId) {
+        return this.endpointFor(deviceId)?.host
+            ?? this.devices.find((device) => device.id === deviceId)?.host;
+    }
     // --- Lifecycle ------------------------------------------------------------
     start() {
         const result = (0, utils_1.validateConfig)(this.config);
@@ -507,6 +529,10 @@ class BluOSPlatform {
         }
     }
     publish(deviceId, observation, reason) {
+        // Ends the window only after the box has already gone quiet. A last-gasp
+        // reading while the ports are still up must not cancel it, or the real
+        // outage that follows is logged as a surprise.
+        this.rebootGrace.clearIfRecovered(this.hostOf(deviceId));
         for (const handler of this.handlers.get(deviceId) ?? []) {
             try {
                 handler.applyObservation(observation, reason);
@@ -517,6 +543,11 @@ class BluOSPlatform {
         }
     }
     reportUnavailable(deviceId, error) {
+        const host = this.hostOf(deviceId);
+        if (this.rebootGrace.isExpected(host)) {
+            this.rebootGrace.noteSilence(host);
+            return;
+        }
         for (const handler of this.handlers.get(deviceId) ?? []) {
             // Guarded exactly like publish. This runs from inside the poll loop's catch
             // block, so a throw here — a characteristic missing from a hand-edited

package/dist/poller.d.ts

@@ -79,6 +79,14 @@ export declare class DevicePoller {
      * update available.
      */
     adoptWriteResult(result: VolumeResult): void;
+    /**
+     * Drop the request in flight and start a plain read.
+     *
+     * Used after a reboot: the long-poll is aimed at a box that is already going
+     * down, and waiting it out only delays the first reading of whatever state the
+     * player comes back in.
+     */
+    refreshNow(): void;
     /** Cancel the request in flight and wake any backoff sleep. */
     private interrupt;
     private run;

package/dist/poller.js

@@ -145,6 +145,17 @@ class DevicePoller {
         this.options.onObservation(merged, 'post-set');
         this.interrupt();
     }
+    /**
+     * Drop the request in flight and start a plain read.
+     *
+     * Used after a reboot: the long-poll is aimed at a box that is already going
+     * down, and waiting it out only delays the first reading of whatever state the
+     * player comes back in.
+     */
+    refreshNow() {
+        this.etag = undefined;
+        this.interrupt();
+    }
     /** Cancel the request in flight and wake any backoff sleep. */
     interrupt() {
         this.abort?.abort();

package/dist/settings.d.ts

@@ -99,6 +99,15 @@ export declare const REBOOT_TIMEOUT_MS = 3000;
 export declare const REBOOT_RESOURCE = "reboot";
 /** @see REBOOT_RESOURCE */
 export declare const REBOOT_FORM: Readonly<Record<string, string>>;
+/**
+ * How long after a reboot request we treat silence as the player coming back.
+ *
+ * A reboot takes the control ports down with the box. Polls fail, and without
+ * this window every accessory on that box would warn "is not responding" and
+ * then info "is responding again" — which is exactly what a reboot looks like.
+ * After this window a still-silent player is logged the usual way.
+ */
+export declare const REBOOT_GRACE_MS = 90000;
 /** Minimum spacing between control calls to one endpoint. */
 export declare const CONTROL_RATE_LIMIT_MS = 100;
 /** First reconnect delay after a failed poll. Doubles up to the ceiling. */

package/dist/settings.js

@@ -12,7 +12,7 @@
  * can tell a vendor requirement apart from a judgement call.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_NAME_LENGTH = exports.MAX_LOG_FIELD_LENGTH = exports.DISCOVERY_VERIFY_CONCURRENCY = exports.MAX_DISCOVERY_CANDIDATES = exports.MAX_DISCOVERY_RECORDS = exports.REDISCOVERY_MIN_INTERVAL_MS = exports.FAILURES_BEFORE_REDISCOVERY = exports.MAX_DISCOVERY_TIMEOUT_SEC = exports.MIN_DISCOVERY_TIMEOUT_SEC = exports.DEFAULT_DISCOVERY_TIMEOUT_SEC = exports.MDNS_SERVICE_SECONDARY = exports.MDNS_SERVICE_PRIMARY = exports.MAX_XML_ATTRIBUTES = exports.MAX_XML_ELEMENTS = exports.MAX_XML_DEPTH = exports.MAX_XML_BYTES = exports.MUTED_DB_SENTINEL = exports.FIXED_VOLUME_SENTINEL = exports.VOLUME_MAX = exports.VOLUME_MIN = exports.MOMENTARY_RESET_MS = exports.SLIDER_COALESCE_MS = exports.DEFAULT_RESTORE_VOLUME = exports.HOMEKIT_WRITE_BUDGET_MS = exports.POLL_FAILURE_REWARN_MS = exports.POLL_FAILURES_BEFORE_UNKNOWN = exports.POLL_BACKOFF_MAX_MS = exports.POLL_BACKOFF_BASE_MS = exports.CONTROL_RATE_LIMIT_MS = exports.REBOOT_FORM = exports.REBOOT_RESOURCE = exports.REBOOT_TIMEOUT_MS = exports.STATUS_TIMEOUT_MS = exports.CONTROL_TIMEOUT_MS = exports.CONNECT_TIMEOUT_MS = exports.SAME_RESOURCE_MIN_GAP_MS = exports.LONG_POLL_READ_SLACK_MS = exports.LONG_POLL_SEC = exports.MAX_PORT = exports.MIN_PORT = exports.DOCUMENTED_BLUOS_PORTS = exports.DEFAULT_BLUOS_PORT = exports.DEFAULT_MODEL = exports.DEFAULT_BRAND = exports.UNKNOWN_PLUGIN_VERSION = exports.PLATFORM_DEVICE_ID = exports.UUID_PREFIX = exports.PLATFORM_NAME = exports.PLUGIN_NAME = void 0;
+exports.MAX_NAME_LENGTH = exports.MAX_LOG_FIELD_LENGTH = exports.DISCOVERY_VERIFY_CONCURRENCY = exports.MAX_DISCOVERY_CANDIDATES = exports.MAX_DISCOVERY_RECORDS = exports.REDISCOVERY_MIN_INTERVAL_MS = exports.FAILURES_BEFORE_REDISCOVERY = exports.MAX_DISCOVERY_TIMEOUT_SEC = exports.MIN_DISCOVERY_TIMEOUT_SEC = exports.DEFAULT_DISCOVERY_TIMEOUT_SEC = exports.MDNS_SERVICE_SECONDARY = exports.MDNS_SERVICE_PRIMARY = exports.MAX_XML_ATTRIBUTES = exports.MAX_XML_ELEMENTS = exports.MAX_XML_DEPTH = exports.MAX_XML_BYTES = exports.MUTED_DB_SENTINEL = exports.FIXED_VOLUME_SENTINEL = exports.VOLUME_MAX = exports.VOLUME_MIN = exports.MOMENTARY_RESET_MS = exports.SLIDER_COALESCE_MS = exports.DEFAULT_RESTORE_VOLUME = exports.HOMEKIT_WRITE_BUDGET_MS = exports.POLL_FAILURE_REWARN_MS = exports.POLL_FAILURES_BEFORE_UNKNOWN = exports.POLL_BACKOFF_MAX_MS = exports.POLL_BACKOFF_BASE_MS = exports.CONTROL_RATE_LIMIT_MS = exports.REBOOT_GRACE_MS = exports.REBOOT_FORM = exports.REBOOT_RESOURCE = exports.REBOOT_TIMEOUT_MS = exports.STATUS_TIMEOUT_MS = exports.CONTROL_TIMEOUT_MS = exports.CONNECT_TIMEOUT_MS = exports.SAME_RESOURCE_MIN_GAP_MS = exports.LONG_POLL_READ_SLACK_MS = exports.LONG_POLL_SEC = exports.MAX_PORT = exports.MIN_PORT = exports.DOCUMENTED_BLUOS_PORTS = exports.DEFAULT_BLUOS_PORT = exports.DEFAULT_MODEL = exports.DEFAULT_BRAND = exports.UNKNOWN_PLUGIN_VERSION = exports.PLATFORM_DEVICE_ID = exports.UUID_PREFIX = exports.PLATFORM_NAME = exports.PLUGIN_NAME = void 0;
 exports.readPluginVersion = readPluginVersion;
 /** npm package name. Must match `package.json` `name` for Homebridge to load us. */
 exports.PLUGIN_NAME = 'homebridge-bluos';
@@ -104,6 +104,15 @@ exports.REBOOT_TIMEOUT_MS = 3_000;
 exports.REBOOT_RESOURCE = 'reboot';
 /** @see REBOOT_RESOURCE */
 exports.REBOOT_FORM = { noheader: '0', yes: '1' };
+/**
+ * How long after a reboot request we treat silence as the player coming back.
+ *
+ * A reboot takes the control ports down with the box. Polls fail, and without
+ * this window every accessory on that box would warn "is not responding" and
+ * then info "is responding again" — which is exactly what a reboot looks like.
+ * After this window a still-silent player is logged the usual way.
+ */
+exports.REBOOT_GRACE_MS = 90_000;
 /** Minimum spacing between control calls to one endpoint. */
 exports.CONTROL_RATE_LIMIT_MS = 100;
 /** First reconnect delay after a failed poll. Doubles up to the ceiling. */

package/dist/utils/index.d.ts

@@ -8,6 +8,7 @@
  */
 export * from './context';
 export * from './errors';
+export * from './reboot-grace';
 export * from './serial';
 export * from './timing';
 export * from './validators';

package/dist/utils/index.js

@@ -24,6 +24,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./context"), exports);
 __exportStar(require("./errors"), exports);
+__exportStar(require("./reboot-grace"), exports);
 __exportStar(require("./serial"), exports);
 __exportStar(require("./timing"), exports);
 __exportStar(require("./validators"), exports);

package/dist/utils/reboot-grace.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview A short window after a reboot request in which silence is expected.
+ *
+ * Reboot takes the box down. The poller then fails, and every accessory on that
+ * address would otherwise warn and later claim to have recovered. That is noise:
+ * we asked it to go down. This clock is what lets the platform stay quiet until
+ * the player answers again, or until the window ends and a real outage remains.
+ *
+ * A reading that arrives before the box actually drops is not recovery. The
+ * control ports often answer one more time after POST /reboot. That last gasp
+ * must not end the window, or the real outage that follows is logged as usual.
+ * Recovery is a successful poll after we have already seen the expected silence.
+ */
+/** Hosts we have just asked to reboot, and when that expectation expires. */
+export declare class RebootGrace {
+    private readonly graceMs;
+    private readonly now;
+    private readonly expiresAt;
+    /** Addresses that have gone quiet at least once inside their window. */
+    private readonly sawSilence;
+    constructor(graceMs: number, now?: () => number);
+    /** Start (or refresh) the quiet window for this address. */
+    expect(host: string): void;
+    /**
+     * Record that this address failed while a reboot was still expected.
+     *
+     * The next successful poll is then treated as the player coming back, not as
+     * a last gasp from a box that has not gone down yet.
+     */
+    noteSilence(host: string | undefined): void;
+    /**
+     * End the window if this address already went quiet and has now answered.
+     *
+     * A success with no prior silence is ignored: the box has not dropped yet.
+     */
+    clearIfRecovered(host: string | undefined): void;
+    /**
+     * End the window now.
+     *
+     * Used when the clock runs out, and by tests. Recovery goes through
+     * {@link clearIfRecovered} so a last-gasp reading cannot cancel the window.
+     */
+    clear(host: string | undefined): void;
+    /** True while a reboot of this address is still expected to look like an outage. */
+    isExpected(host: string | undefined): boolean;
+}

package/dist/utils/reboot-grace.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview A short window after a reboot request in which silence is expected.
+ *
+ * Reboot takes the box down. The poller then fails, and every accessory on that
+ * address would otherwise warn and later claim to have recovered. That is noise:
+ * we asked it to go down. This clock is what lets the platform stay quiet until
+ * the player answers again, or until the window ends and a real outage remains.
+ *
+ * A reading that arrives before the box actually drops is not recovery. The
+ * control ports often answer one more time after POST /reboot. That last gasp
+ * must not end the window, or the real outage that follows is logged as usual.
+ * Recovery is a successful poll after we have already seen the expected silence.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RebootGrace = void 0;
+/** Hosts we have just asked to reboot, and when that expectation expires. */
+class RebootGrace {
+    graceMs;
+    now;
+    expiresAt = new Map();
+    /** Addresses that have gone quiet at least once inside their window. */
+    sawSilence = new Set();
+    constructor(graceMs, now = Date.now) {
+        this.graceMs = graceMs;
+        this.now = now;
+    }
+    /** Start (or refresh) the quiet window for this address. */
+    expect(host) {
+        this.expiresAt.set(host, this.now() + this.graceMs);
+        this.sawSilence.delete(host);
+    }
+    /**
+     * Record that this address failed while a reboot was still expected.
+     *
+     * The next successful poll is then treated as the player coming back, not as
+     * a last gasp from a box that has not gone down yet.
+     */
+    noteSilence(host) {
+        if (host !== undefined && this.isExpected(host)) {
+            this.sawSilence.add(host);
+        }
+    }
+    /**
+     * End the window if this address already went quiet and has now answered.
+     *
+     * A success with no prior silence is ignored: the box has not dropped yet.
+     */
+    clearIfRecovered(host) {
+        if (host !== undefined && this.sawSilence.has(host)) {
+            this.clear(host);
+        }
+    }
+    /**
+     * End the window now.
+     *
+     * Used when the clock runs out, and by tests. Recovery goes through
+     * {@link clearIfRecovered} so a last-gasp reading cannot cancel the window.
+     */
+    clear(host) {
+        if (host !== undefined) {
+            this.expiresAt.delete(host);
+            this.sawSilence.delete(host);
+        }
+    }
+    /** True while a reboot of this address is still expected to look like an outage. */
+    isExpected(host) {
+        if (host === undefined) {
+            return false;
+        }
+        const expires = this.expiresAt.get(host);
+        if (expires === undefined) {
+            return false;
+        }
+        if (this.now() >= expires) {
+            this.clear(host);
+            return false;
+        }
+        return true;
+    }
+}
+exports.RebootGrace = RebootGrace;

package/docs/FEATURES.md

@@ -12,8 +12,8 @@ A checklist of what is built. The plugin aims to cover everything about a BluOS
 - ✅ Mute switch, with unmute restoring the level the player remembered instead of a guess
 - ✅ Volume preset switches: one exact level per switch, addressable by name with Siri; set On sets the level, set Off is a no-op
 - ✅ Battery sensor (level, charging state, low-battery) for players with a battery pack fitted
-- ✅ Reboot switch per player, momentary so a scene or "turn everything off" cannot restart the stereo, and still pressable when the player has stopped answering. Restarts the whole box on a multi-zone chassis, which BluOS gives no way to avoid, and warns at startup when that means other configured rooms
-- ✅ Optional "reboot all" switch that restarts every BluOS player on the network, naming each one in the log before anything is sent, and sending once per box instead of once per zone. You choose its name with `options.rebootAllName`, so it can sit in whichever Home app room suits you
+- ✅ Reboot switch per player, momentary so a scene or "turn everything off" cannot reboot the stereo, and still pressable when the player has stopped answering. Reboots the whole box on a multi-zone chassis, which BluOS gives no way to avoid, and warns at startup when that means other configured rooms
+- ✅ Optional "reboot all" switch that reboots every BluOS player on the network, sending once per box instead of once per zone. The info log is a count (`found … device(s), … player(s)`), then `N of N device(s) rebooted`. The debug log names each box before anything is sent. Accessories on a box that was just rebooted stay quiet until it answers again, then take its live state. You choose its name with `options.rebootAllName`, so it can sit in whichever Home app room suits you
 - ✅ Fixed-output players detected from `volume="-1"` and given no slider, with one explanatory log line
 - ✅ Multi-zone chassis support (NAD CI S2, CI 580): each zone is a separate player on its own port
 - ✅ mDNS discovery in the settings page, with manual address entry for networks that filter multicast
@@ -89,7 +89,7 @@ HomeKit has no way to render a library or a queue, and no vocabulary for "play t
 
 | Configuration | HomeKit service |
 | --- | --- |
-| `options.rebootAll` | Switch, momentary. One for the whole install, restarting every box it can find. Named by `options.rebootAllName` |
+| `options.rebootAll` | Switch, momentary. One for the whole install, rebooting every box it can find. Named by `options.rebootAllName` |
 
 ## Protocol surface
 

package/docs/README-DETAILED.md

@@ -38,9 +38,9 @@ Where HomeKit is genuinely better is the tile, the scene, the automation and the
 
 **Battery sensor.** Charge level, charging state and low-battery warning, for players with a battery pack fitted (PULSE FLEX with BP100, PULSE M).
 
-**Reboot switch.** Restarts the player. It springs back to off and ignores being switched off, so a scene or "turn everything off" cannot restart your stereo. It stays pressable while a player is showing No Response, which is exactly when you want it.
+**Reboot switch.** Reboots the player. It springs back to off and ignores being switched off, so a scene or "turn everything off" cannot reboot your stereo. It stays pressable while a player is showing No Response, which is exactly when you want it.
 
-On a multi-zone chassis it restarts both zones. BluOS serves reboot on the box's own web server, not on a zone's control port, so "Study Reboot" on a CI S2 also takes down the other room. There is no way to avoid this. The plugin names the other affected rooms in the log at startup.
+On a multi-zone chassis it reboots both zones. BluOS serves reboot on the box's own web server, not on a zone's control port, so "Study Reboot" on a CI S2 also takes down the other room. There is no way to avoid this. At startup the plugin warns, naming the other affected rooms.
 
 **Grouping awareness.** A zone that is leading a BluOS group moves the whole group, exactly as its slider does in the BluOS app. Every other zone moves alone. The scope is stated explicitly on every write, never left to the firmware default.
 
@@ -48,9 +48,9 @@ On a multi-zone chassis it restarts both zones. BluOS serves reboot on the box's
 
 ### For the whole install
 
-**Reboot all.** Off by default. One switch that restarts **every BluOS player it can find on the network**, not only the ones listed in your configuration. It sweeps with mDNS and adds your configured players, so it still works where multicast is filtered.
+**Reboot all.** Off by default. One switch that reboots **every BluOS player it can find on the network**, not only the ones listed in your configuration. It sweeps with mDNS and adds your configured players, so it still works where multicast is filtered.
 
-Every player is named in the Homebridge log before a single request goes out. One press sends one restart per box, so a multi-zone chassis restarts once and takes all of its zones with it. A box that cannot be reached is reported, and the rest still go.
+The info log is a count (`found 2 device(s), 3 player(s)`), then `2 of 2 device(s) rebooted`. The debug log names every box and the players on it before a request goes out. One press sends one reboot per box, so a multi-zone chassis reboots once and takes all of its zones with it. A box that cannot be reached is a warning (`could not reboot`), and the rest still go.
 
 Name it with `options.rebootAllName`. It is the one accessory with no room of its own, so you choose where it lives in the Home app.
 
@@ -88,7 +88,7 @@ Only one `BluOS` platform block is supported (`singular` in the schema). It can
 | `devices` | ✓ | List of players. An empty list is allowed and warns. A missing or non-list value is an error |
 | `options.sliderService` | | `fan` (default) or `lightbulb`, for every slider |
 | `options.discoveryTimeoutSec` | | mDNS listening window, 1–30 seconds (default 5) |
-| `options.rebootAll` | | Expose one switch that restarts **every BluOS player on the network** (default false). Its reach is not limited to `devices[]` |
+| `options.rebootAll` | | Expose one switch that reboots **every BluOS player on the network** (default false). Its reach is not limited to `devices[]` |
 | `options.rebootAllName` | | What that switch is called in the Home app, so you can keep it in the room you want. Defaults to the plugin name followed by `Reboot All` |
 
 ### `devices[]` entries
@@ -103,7 +103,7 @@ Only one `BluOS` platform block is supported (`singular` in the schema). It can
 | `sliderService` | | Override the platform slider style for this player. Empty means "use the platform setting". Changing it removes the old control from the accessory instead of leaving both |
 | `mute` | | Expose a mute switch (default false) |
 | `battery` | | Expose a battery sensor (default false, and only meaningful with a battery pack) |
-| `reboot` | | Expose a switch that restarts this player (default false). Restarting interrupts playback, and on a multi-zone chassis it restarts every zone on that box |
+| `reboot` | | Expose a switch that reboots this player (default false). Rebooting interrupts playback, and on a multi-zone chassis it reboots every zone on that box |
 | `volumePresets[]` | | `{ "name": "...", "volume": 0-100 }`. Duplicate levels on one player are skipped with a warning |
 
 ### A complete example
@@ -188,6 +188,29 @@ A HomeKit write that reached the player:
 
 Mute `ON` means muted. `(group)` means that zone is leading a BluOS group, so the write carried the followers.
 
+A Reboot All press. Info is the count and the result. Debug names every box.
+
+```text
+[BluOS] Downstairs Reboot: found 2 device(s), 3 player(s)
+[BluOS] Downstairs Reboot: rebooting 2 box(es) carrying 3 player(s): 192.168.4.11 (Zone One, Zone Two); 192.168.4.12 (Kitchen)
+[BluOS] Downstairs Reboot: 2 of 2 device(s) rebooted
+```
+
+The middle line is debug. A box that did not take the request is a warning:
+
+```text
+[BluOS] Downstairs Reboot: could not reboot 192.168.4.11 (Zone One, Zone Two): connect EHOSTUNREACH
+[BluOS] Downstairs Reboot: 1 of 2 device(s) rebooted
+```
+
+A per-player reboot switch on a shared chassis, at startup:
+
+```text
+[BluOS] Zone One Reboot: will also reboot Zone Two: they are zones of one chassis, and BluOS reboots the whole box
+```
+
+After a reboot the other accessories stay quiet. The player is expected to stop answering, so they do not log `is not responding` or `is responding again`. A reading that arrives before the box actually drops is ignored for that purpose: the control ports often answer once more after the reboot is sent. The first successful poll after the silence writes whatever the player is actually doing into HomeKit. A player that is still silent after that window is logged as not responding, the usual way.
+
 A configuration the plugin will not act on:
 
 ```text
@@ -232,9 +255,9 @@ Ordered by how well HomeKit expresses the thing, not by how easy it is to build.
 6. **A zone on a multi-zone chassis is missing.** Check the port. Zone two is 11010, not 11000
 7. **The volume moved but the slider did not, for a second.** A change made on the player takes one long-poll round trip to arrive. A change made from HomeKit is immediate
 8. **One zone's slider moved several rooms.** That zone is currently leading a BluOS group, so it carries its followers, the same as its slider in the BluOS app. Ungroup in the BluOS app and it goes back to moving alone
-9. **The reboot switch turns itself off.** This is by design. It is a button, not a state: it fires when switched on, then springs back. Switching it off does nothing, which is what stops a scene or "turn everything off" from restarting your stereo
-10. **Reboot All restarted a player you did not configure.** Also by design, and the reason it is off by default. It sweeps the network instead of reading `devices[]`. The log lists every player it is about to restart, by name and address
-11. **A reboot switch restarted the room next door.** Expect this on a multi-zone chassis such as a CI S2. BluOS serves `/reboot` on the box's own web server, not on a zone's control port, so there is no way to restart one zone of a shared box. The plugin logs a warning naming the other rooms when it starts
+9. **The reboot switch turns itself off.** This is by design. It is a button, not a state: it fires when switched on, then springs back. Switching it off does nothing, which is what stops a scene or "turn everything off" from rebooting your stereo
+10. **Reboot All rebooted a player you did not configure.** Also by design, and the reason it is off by default. It sweeps the network instead of reading `devices[]`. The info log is a count (`found … device(s), … player(s)`); the debug log lists every player by name and address
+11. **A reboot switch rebooted the room next door.** Expect this on a multi-zone chassis such as a CI S2. BluOS serves `/reboot` on the box's own web server, not on a zone's control port, so there is no way to reboot one zone of a shared box. At startup the plugin warns, naming the other rooms
 12. **100 is louder than you ever want.** Set the limit on the player, in the BluOS app's settings for it. The wording varies by model: a volume limit on Bluesound players, a maximum volume on NAD amplifiers. The plugin deliberately has no ceiling of its own, so a limit set on the player is enforced by the hardware for every controller. No HomeKit automation or misheard Siri phrase can exceed it, and a second limit here could only disagree with the first
 13. Restart Homebridge after editing `config.json` by hand
 

package/homebridge-ui/public/index.js

@@ -378,7 +378,7 @@
       (value) => { player.battery = value },
     ))
     options.append(checkbox(
-      'Reboot switch (restarts this player, and any zone sharing its box)',
+      'Reboot switch (reboots this player, and any zone sharing its box)',
       player.reboot,
       false,
       (value) => { player.reboot = value },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-bluos",
   "displayName": "Homebridge BluOS",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Homebridge plugin for BluOS players — per-zone volume, mute, volume-preset and battery accessories over the LAN Custom Integration API. Verified on NAD and Bluesound hardware",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",