@tplnet/homebridge-denon-heos-audio 1.2.1 → 1.2.4

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes of this fork. The fork is based on [hov3rcraft/homebridge-denon-heos-audio](https://github.com/hov3rcraft/homebridge-denon-heos-audio) 1.0.0-beta.1.
 
+## 1.2.4
+
+### Changed
+
+- Shorter npm description without the fork notice, so the search results in the Homebridge UI show the supported devices and features. The fork is mentioned at the top of the README and in the credits.
+
+1.2.3 was not published on npm; its changes are included in 1.2.4.
+
+## 1.2.3
+
+### Changed
+
+- Easier to find in the plugin search of the Homebridge UI: new display name *Homebridge Denon & Marantz HEOS (tplnet)*, a description that names the supported devices and features, and more keywords (Denon Home, Home Amp, Marantz Cinema, AV receiver, amplifier, soundbar, Apple Home).
+- Documentation: *Apple Home* instead of *HomeKit*; *Compatibility and security* section and badges; troubleshooting for devices that appear offline in the Homebridge UI.
+
+### Security / CI
+
+- Weekly *Compatibility & CVE check* with homebridge@latest and @beta on Node.js 22, 24 and 26, Dependabot for dependency updates.
+
+## 1.2.2
+
+### Fixed
+
+- The tile in the Homebridge UI / Home app no longer jumps back to "off" while switching on takes a few seconds: HomeKit gets the answer immediately and switching continues in the background. If switching fails, the tile shows the real state again and the error is logged.
+- A radio station that needs a few seconds to buffer is no longer replaced by the power on favorite: the plugin now waits up to 8 seconds (before: 3) for playback to start.
+
 ## 1.2.1
 
 ### Fixed

package/README.md

@@ -1,4 +1,11 @@
-# Homebridge Denon Heos Audio
+# Homebridge Denon & Marantz HEOS (tplnet)
+
+[![npm](https://img.shields.io/npm/v/@tplnet/homebridge-denon-heos-audio)](https://www.npmjs.com/package/@tplnet/homebridge-denon-heos-audio)
+[![CI](https://github.com/tplnet/homebridge-denon-heos-audio/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/tplnet/homebridge-denon-heos-audio/actions/workflows/ci.yml)
+[![Compatibility & CVE check](https://github.com/tplnet/homebridge-denon-heos-audio/actions/workflows/compat.yml/badge.svg)](https://github.com/tplnet/homebridge-denon-heos-audio/actions/workflows/compat.yml)
+[![License](https://img.shields.io/npm/l/@tplnet/homebridge-denon-heos-audio)](LICENSE)
+
+Package: [`@tplnet/homebridge-denon-heos-audio`](https://www.npmjs.com/package/@tplnet/homebridge-denon-heos-audio)
 
 Control your **Denon and Marantz HEOS speakers, amplifiers and AV receivers** from Apple Home.
 
@@ -9,9 +16,6 @@ Each device appears in the Home app as a TV accessory, so you can:
 - pick an input (HDMI ARC, optical, AUX, …)
 - play, pause and skip tracks with the Remote in Control Center
 
-[![npm](https://img.shields.io/npm/v/@tplnet/homebridge-denon-heos-audio)](https://www.npmjs.com/package/@tplnet/homebridge-denon-heos-audio)
-[![CI](https://github.com/tplnet/homebridge-denon-heos-audio/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/tplnet/homebridge-denon-heos-audio/actions/workflows/ci.yml)
-
 > This is a fork of [hov3rcraft/homebridge-denon-heos-audio](https://github.com/hov3rcraft/homebridge-denon-heos-audio) with stability fixes
 > (no more Homebridge crashes on unexpected device messages), automatic setup of discovered devices, inputs read from the device,
 > Marantz support and automated tests. See the [changelog](CHANGELOG.md).
@@ -56,9 +60,9 @@ Not sure what your device supports? Turn on [device discovery](#1-find-your-devi
 | **Hybrid** | AV receivers and amplifiers with HEOS (e.g. Marantz Cinema series, Denon AVR-X, Denon Home Amp) | Real power on / standby | ✅ | ✅ |
 
 **Why does "power" mean "playback" with HEOS CLI?** HEOS speakers have no real standby command. The plugin therefore treats "playing" as on and "stopped/paused" as off.
-Switching on resumes the last source. If there is nothing to resume (e.g. after the speaker was restarted or a streaming session ended), or playback doesn't start within 3 seconds, the first HEOS favorite is started, so switching on also works in scenes and automations. You can choose another favorite or turn this off with `powerOnFavorite`.
+Switching on resumes the last source. If there is nothing to resume (e.g. after the speaker was restarted or a streaming session ended), or playback doesn't start within 8 seconds, the first HEOS favorite is started, so switching on also works in scenes and automations. You can choose another favorite or turn this off with `powerOnFavorite`.
 
-> **Requirement:** at least one favorite in the HEOS app (*Music → Favorites*, e.g. a radio station). Without a favorite, a speaker that has nothing to resume can't be switched on from HomeKit.
+> **Requirement:** at least one favorite in the HEOS app (*Music → Favorites*, e.g. a radio station). Without a favorite, a speaker that has nothing to resume can't be switched on from Apple Home.
 
 **Hybrid** uses AVR Control for power and HEOS CLI for everything else. Pick it whenever discovery reports both protocols and you want real standby.
 
@@ -181,7 +185,7 @@ See the next section.
 
 ## Adding a device to Apple Home (step by step)
 
-HomeKit allows only one TV per bridge. That's why every device is published as its **own accessory**. It does **not** appear in the Home app automatically together with your other Homebridge accessories, so you have to add each device once.
+Apple Home allows only one TV per bridge. That's why every device is published as its **own accessory**. It does **not** appear in the Home app automatically together with your other Homebridge accessories, so you have to add each device once.
 
 **Before you start**
 
@@ -313,30 +317,27 @@ then restart Homebridge **once** and reload the page.
 **Homebridge doesn't start: `EADDRINUSE: address already in use`.**
 Usually an old Homebridge process is still running (e.g. after several restarts in a row): `ps aux | grep -i [h]omebridge` shows two main `homebridge` processes. Stop Homebridge, end the old process (`kill <pid>`) and start Homebridge again.
 
-**A device is added automatically although I don't want it in HomeKit.**
+**A device is added automatically although I don't want it in Apple Home.**
 Add its serial number to `excludedSerialNumbers` and restart Homebridge. Then remove it from the Home app.
 
 **Getting more details:** enable debug logging for Homebridge (or `consoleLogEnabled`) and include the log when [opening an issue](https://github.com/tplnet/homebridge-denon-heos-audio/issues).
 
 ## Compatibility and security
 
-Every change is checked against the current Homebridge release and for known vulnerabilities (CVEs):
-
-| Checked | Versions |
-| --- | --- |
-| Homebridge | 1.11.4 and 2.5.0 (HAP-NodeJS 0.14.3 / 2.3.0) |
-| Node.js | 22, 24 and 26 (Homebridge 1.x: up to 24) |
-| Known vulnerabilities | `npm audit`: 0 findings (runtime and development dependencies) |
+This plugin is kept compatible with the **newest Homebridge release** and free of **known vulnerabilities (CVEs)**:
 
-*Last checked: November 2026.* The GitHub workflow repeats these checks on every push and **weekly**, so new Homebridge releases and newly published CVEs are noticed even without code changes.
+- **Weekly and on every dependency change** the [Compatibility & CVE check](https://github.com/tplnet/homebridge-denon-heos-audio/actions/workflows/compat.yml) workflow
+  - runs `npm audit` – any known vulnerability in the runtime dependencies fails the check,
+  - builds the plugin and starts it with **homebridge@latest** and **homebridge@beta** on Node.js 22, 24 and 26 with simulated HEOS and AVR Control devices (`npm run smoke`): the plugin must load, be accepted as compatible (`engines`), connect to the devices, read their inputs and run without errors, HAP warnings or deprecation warnings.
+- **On every push** the [CI](https://github.com/tplnet/homebridge-denon-heos-audio/actions/workflows/ci.yml) workflow runs lint, the unit tests and the smoke test, also with **Homebridge 1.x** (on Node.js 22 and 24).
+- **Every release** runs the same CVE and Homebridge checks before the version is staged on npm – a release with a known vulnerability or an incompatibility is not published.
+- **Dependabot** opens weekly pull requests for dependency and GitHub Actions updates.
 
-To run all checks locally:
+Requirements: Homebridge 1.8 or newer (2.x supported), Node.js 22.12+, 24 or 26.
 
-```bash
-npm run check   # npm audit + lint + unit tests + smoke test
-```
+Run all checks locally with `npm run check` (`npm audit`, lint, unit tests, smoke test). To test another Homebridge version, install it temporarily with `npm install --no-save homebridge@<version>`.
 
-The smoke test (`npm run smoke`) starts the installed Homebridge version with simulated HEOS and AVR Control devices and fails on errors, HAP warnings or deprecation warnings. To test another Homebridge version, install it temporarily with `npm install --no-save homebridge@<version>`.
+Found a security issue? Please report it privately via GitHub (*Security* → *Report a vulnerability*) instead of a public issue.
 
 ## Development
 

package/config.schema.json

@@ -81,7 +81,7 @@
             },
             "volumeLimitEnabled": {
               "title": "Volume Limit",
-              "description": "When you set a volume limit, 100% volume in HomeKit will correspond to this percentage on your device.",
+              "description": "When you set a volume limit, 100% volume in the Home app will correspond to this percentage on your device.",
               "type": "boolean",
               "required": false,
               "default": false
@@ -216,7 +216,7 @@
                   },
                   "showInList": {
                     "title": "Show in Input List",
-                    "description": "If disabled, this input will not be shown in the list of selectable inputs in HomeKit.",
+                    "description": "If disabled, this input will not be shown in the list of selectable inputs in the Home app.",
                     "type": "boolean",
                     "required": false,
                     "default": true

package/dist/denonClientHeosCli.js

@@ -248,7 +248,8 @@ export class DenonClientHeosCli extends DenonClient {
     player_id;
     /** HEOS favorite (1, 2, …) that is started when switching on without something to resume; 0 = disabled. */
     powerOnFavorite = 1;
-    static PLAY_VERIFY_CHECKS = 3;
+    // radio streams may need a few seconds of buffering before the device reports "play"
+    static PLAY_VERIFY_CHECKS = 8;
     playVerifyIntervalMs = 1000;
     /** Log for actions the user should see without debug logging (e.g. starting the power on favorite). */
     infoLog = (message) => this.debugLog(message);

package/dist/platformAccessory.d.ts

@@ -39,6 +39,8 @@ export declare class DenonAudioAccessory {
     private volumeChangeOngoing;
     private pendingActive;
     private powerChangeInProgress;
+    /** The power change running in the background (for tests). */
+    private powerChange;
     private playingChangeOngoing;
     constructor(platform: DenonAudioPlatform, accessory: PlatformAccessory, config: DeviceConfig, log: Logger);
     /**

package/dist/platformAccessory.js

@@ -45,6 +45,8 @@ export class DenonAudioAccessory {
     volumeChangeOngoing = false;
     pendingActive;
     powerChangeInProgress = false;
+    /** The power change running in the background (for tests). */
+    powerChange;
     playingChangeOngoing = false;
     constructor(platform, accessory, config, log) {
         log.debug("Initializing DenonAudioAccessory...");
@@ -317,18 +319,23 @@ export class DenonAudioAccessory {
         // started), and the device reports intermediate states during that time.
         this.pendingActive = { value: active, until: Number.POSITIVE_INFINITY };
         this.powerChangeInProgress = true;
-        try {
-            await this.denonClient.setPower(active);
+        // HomeKit gets the answer immediately; switching continues in the background. Otherwise HomeKit / the Homebridge UI
+        // would show the old state until switching on has finished (which can take several seconds).
+        this.powerChange = this.denonClient
+            .setPower(active)
+            .then(() => {
             this.pendingActive = { value: active, until: Date.now() + DenonAudioAccessory.POWER_STATE_SETTLE_TIME };
-        }
-        catch (error) {
+        })
+            .catch(async (error) => {
             this.pendingActive = undefined;
             this.log.error(`An error occured while setting power status for ${this.name}.`, error);
-            throw new this.platform.api.hap.HapStatusError(this.platform.api.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE);
-        }
-        finally {
+            // show the real state again
+            const deviceState = await this.denonClient.getPower().catch(() => !active);
+            this.tvService.updateCharacteristic(this.platform.Characteristic.Active, deviceState);
+        })
+            .finally(() => {
             this.powerChangeInProgress = false;
-        }
+        });
     }
     async setActiveIdentifier(newValue) {
         this.log.debug(`setActiveIdentifier for ${this.name} set to ${newValue}`);

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@tplnet/homebridge-denon-heos-audio",
-  "displayName": "Homebridge Denon Heos Audio (tplnet)",
+  "displayName": "Homebridge Denon & Marantz HEOS (tplnet)",
   "type": "module",
-  "version": "1.2.1",
-  "description": "Control your Denon and Marantz HEOS speakers, amplifiers and AVRs via AVR Control and/or HEOS CLI",
+  "version": "1.2.4",
+  "description": "Denon and Marantz HEOS devices in Apple Home: Denon Home speakers, Home Amp and AV receivers (e.g. Marantz Cinema, Denon AVR). Power, volume, inputs, play/pause, automatic discovery.",
   "author": "tplnet",
   "contributors": [
     "hov3rcraft (original author, https://github.com/hov3rcraft)"
@@ -22,14 +22,24 @@
     "provenance": true
   },
   "keywords": [
-    "homebridge",
     "homebridge-plugin",
+    "homebridge",
     "denon",
     "marantz",
     "heos",
+    "denon-home",
+    "home-amp",
+    "marantz-cinema",
     "avr",
+    "av-receiver",
+    "receiver",
+    "amplifier",
     "speaker",
+    "soundbar",
     "ceol",
+    "apple-home",
+    "homekit",
+    "tv",
     "avrcontrol",
     "heoscli",
     "heos-cli"