@tplnet/homebridge-heos-multiroom-audio 0.0.0-stage → 1.5.0-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +235 -0
- package/LICENSE +674 -0
- package/README.md +444 -2
- package/config.schema.json +364 -0
- package/dist/config.d.ts +20 -0
- package/dist/config.js +5 -0
- package/dist/controlMode.d.ts +9 -0
- package/dist/controlMode.js +15 -0
- package/dist/customLogging.d.ts +27 -0
- package/dist/customLogging.js +87 -0
- package/dist/denonClient.d.ts +179 -0
- package/dist/denonClient.js +333 -0
- package/dist/denonClientAvrControl.d.ts +104 -0
- package/dist/denonClientAvrControl.js +271 -0
- package/dist/denonClientHeosCli.d.ts +284 -0
- package/dist/denonClientHeosCli.js +722 -0
- package/dist/denonClientHybrid.d.ts +28 -0
- package/dist/denonClientHybrid.js +67 -0
- package/dist/denonProtocol.d.ts +6 -0
- package/dist/denonProtocol.js +46 -0
- package/dist/deviceOverview.d.ts +36 -0
- package/dist/deviceOverview.js +64 -0
- package/dist/discovery.d.ts +27 -0
- package/dist/discovery.js +47 -0
- package/dist/heosDiscovery.d.ts +88 -0
- package/dist/heosDiscovery.js +250 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.js +9 -0
- package/dist/platform.d.ts +79 -0
- package/dist/platform.js +364 -0
- package/dist/platformAccessory.d.ts +100 -0
- package/dist/platformAccessory.js +672 -0
- package/dist/promiseTimeoutException.d.ts +5 -0
- package/dist/promiseTimeoutException.js +11 -0
- package/dist/protocolCheck.d.ts +20 -0
- package/dist/protocolCheck.js +46 -0
- package/dist/settings.d.ts +8 -0
- package/dist/settings.js +9 -0
- package/dist/volumeLimit.d.ts +15 -0
- package/dist/volumeLimit.js +32 -0
- package/package.json +111 -4
- package/schemas/config.schema.de.json +364 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
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.
|
|
4
|
+
|
|
5
|
+
## 1.5.0-beta.1 (2026-11-19)
|
|
6
|
+
|
|
7
|
+
### Changed
|
|
8
|
+
|
|
9
|
+
- **New name: "Homebridge HEOS Multiroom-Audio (tplnet)"**, npm package `@tplnet/homebridge-heos-multiroom-audio` (before: `@tplnet/homebridge-denon-heos-audio`), repository `tplnet/homebridge-heos-multiroom-audio`. HEOS is the multiroom audio system of Denon and Marantz; the new name describes it better. Switching: uninstall the old package in the terminal and install the new one (see README, "Switching from @tplnet/homebridge-denon-heos-audio"). The platform name `DenonHeosAudio` and the configuration stay the same, the devices keep their pairing in Apple Home.
|
|
10
|
+
- npm description and keywords: more search terms (multiroom, multi-room, Denon HEOS, Marantz HEOS, Denon AVR, Marantz AVR, Siri, …).
|
|
11
|
+
|
|
12
|
+
No changes to the functions of the plugin.
|
|
13
|
+
|
|
14
|
+
## 1.4.1-beta.1 (2026-11-19)
|
|
15
|
+
|
|
16
|
+
First beta: from now on every change is published as a beta first and becomes a regular version after it has been tested.
|
|
17
|
+
|
|
18
|
+
### Changed
|
|
19
|
+
|
|
20
|
+
- Betas are published with the npm dist-tag `beta` (before: `next`), so the Homebridge UI offers newer betas to users who run a beta of this plugin. The README explains how to install a beta (Homebridge UI → *Manage Version*) and how to go back to the regular version; new badge with the current beta.
|
|
21
|
+
- README: plugin icon at the top (also on npm and in the Homebridge UI).
|
|
22
|
+
- SECURITY.md: reports are handled on a best-effort basis.
|
|
23
|
+
|
|
24
|
+
No changes to the plugin code.
|
|
25
|
+
|
|
26
|
+
## 1.4.0 (2026-11-18)
|
|
27
|
+
|
|
28
|
+
### Added
|
|
29
|
+
|
|
30
|
+
- Switching on can start a **Quick Select** slot of the device (the numbered buttons, e.g. 1–3 on a Denon Home 150, 1–6 on a Denon Home 300) instead of a HEOS favorite when the speaker has nothing to resume: new option *Power On Quick Select* (`powerOnQuickSelect`, HEOS CLI only, 0 = use the HEOS favorite). At startup the plugin warns if the slot doesn't exist on the device; the debug log shows its name.
|
|
31
|
+
|
|
32
|
+
### Changed
|
|
33
|
+
|
|
34
|
+
- *Power On Favorite* accepts up to 200, the maximum number of favorites in the HEOS app. Its description explains that the number is the position in the favorite list of the HEOS app (*Music → Favorites*).
|
|
35
|
+
|
|
36
|
+
## 1.3.4 (2026-11-18)
|
|
37
|
+
|
|
38
|
+
### Fixed
|
|
39
|
+
|
|
40
|
+
- The settings form no longer shows "Config validation failed" because of an empty entry it adds by itself (e.g. an empty input). Lists start empty, and inputs without input ID or name are ignored by the plugin.
|
|
41
|
+
|
|
42
|
+
### Changed
|
|
43
|
+
|
|
44
|
+
- *Power On Favorite* is a number field instead of a slider in the settings form.
|
|
45
|
+
- At startup the plugin checks the power on favorite against the favorites in the HEOS app (HEOS CLI devices) and warns if it doesn't exist or if there are no favorites. The name of the favorite is shown in the debug log.
|
|
46
|
+
|
|
47
|
+
## 1.3.3 (2026-11-18)
|
|
48
|
+
|
|
49
|
+
### Changed
|
|
50
|
+
|
|
51
|
+
- Clearer settings form in the Homebridge UI: discovery options at the top, the manual devices in their own expandable section with the settings of each device grouped into *Volume*, *Switching on (HEOS CLI)* and *Inputs*, console log options under *Troubleshooting*. Also in the German form.
|
|
52
|
+
- Settings form texts: "HEOS CLI" spelled correctly, the volume limit field has a title, clearer descriptions of the device list and the volume step size; Marantz devices are no longer left out ("Add your Denon devices here").
|
|
53
|
+
- Removed the unused option "Selectable playing sources" from the settings form (it had no effect).
|
|
54
|
+
- Releases are blocked only by vulnerabilities in the runtime dependencies, like in the other tplnet projects; findings in development tools are reported.
|
|
55
|
+
|
|
56
|
+
### Fixed
|
|
57
|
+
|
|
58
|
+
- Console log (`consoleLogEnabled`) without a log level no longer stays silent; it uses `debug`, like the default in the settings form.
|
|
59
|
+
|
|
60
|
+
## 1.3.2
|
|
61
|
+
|
|
62
|
+
### Fixed
|
|
63
|
+
|
|
64
|
+
- Devices no longer show "No Response" in Apple Home after a Homebridge restart because their port changed. Every device now gets the same port at every start (as long as the same devices are there): the devices of the start – manual ones and the ones found by the discovery within the first 10 seconds – are published together, sorted by serial number. Before, the order depended on which device answered first, so the ports were shuffled and Apple Home sometimes kept connecting to the old port. Devices found later are published right away.
|
|
65
|
+
- With device discovery enabled, the devices appear in Apple Home about 10 seconds after the start.
|
|
66
|
+
|
|
67
|
+
### Changed
|
|
68
|
+
|
|
69
|
+
- README: troubleshooting for "No Response" after a restart (restart only the child bridge, check the announced port with `dns-sd`).
|
|
70
|
+
|
|
71
|
+
The ports are assigned once in the new order after updating; afterwards they stay the same.
|
|
72
|
+
|
|
73
|
+
## 1.3.1
|
|
74
|
+
|
|
75
|
+
### Changed
|
|
76
|
+
|
|
77
|
+
- Shorter log at startup: the details of each discovered device ("Found Denon / Marantz device …", about 8 lines per device) and the notes about manually configured or excluded devices are only written to the debug log. The device overview lists all devices with their status; "Automatically adding discovered device …" stays in the normal log.
|
|
78
|
+
|
|
79
|
+
## 1.3.0
|
|
80
|
+
|
|
81
|
+
### Added
|
|
82
|
+
|
|
83
|
+
- Device overview in the log: about 30 seconds after the start, a table lists every device found in the network and every manually configured device with its status – *added automatically*, *added manually* (or *not found in the network*) or *not added* with the reason (automatic adding disabled, excluded, not reachable, no supported protocol). Devices found later lead to an updated overview.
|
|
84
|
+
|
|
85
|
+
### Changed
|
|
86
|
+
|
|
87
|
+
- README: disclaimer (private hobby project, AI-assisted development, use at your own risk, best-effort support).
|
|
88
|
+
|
|
89
|
+
## 1.2.7
|
|
90
|
+
|
|
91
|
+
### Changed
|
|
92
|
+
|
|
93
|
+
- README: router-neutral instructions for a fixed IP address, corrected Home app usage (tap the tile; the volume is changed with the Remote in Control Center, the Home app has no volume slider for TV accessories), "Nintendo Switch" in the input example.
|
|
94
|
+
- Release notes of GitHub releases are taken from `CHANGELOG.md`, like in homebridge-tahoma. They also list what was checked for the release (newest Homebridge release, `npm audit`, tests, supported Node.js and Homebridge versions) and link to the changelog. `npm version` refuses to run without a changelog section; a new workflow fills existing releases.
|
|
95
|
+
|
|
96
|
+
No changes to the plugin code.
|
|
97
|
+
|
|
98
|
+
## 1.2.6
|
|
99
|
+
|
|
100
|
+
### Added
|
|
101
|
+
|
|
102
|
+
- German settings form in the Homebridge UI (`schemas/config.schema.de.json`), shown when the UI language is set to Deutsch. A test keeps the fields, defaults and limits identical to the English form. The README lists the supported languages.
|
|
103
|
+
|
|
104
|
+
## 1.2.5
|
|
105
|
+
|
|
106
|
+
### Fixed
|
|
107
|
+
|
|
108
|
+
- The speaker part (volume, mute) is now linked to the TV, as Apple recommends for TV accessories. The Home app no longer shows it as a separate speaker tile. If an existing speaker tile remains, restart Homebridge; if it is still there, remove it in the Home app (the TV tile keeps working).
|
|
109
|
+
|
|
110
|
+
### Security
|
|
111
|
+
|
|
112
|
+
- Automatic discovery only fetches the device description from the device that answered the search. A manipulated answer can no longer make the plugin fetch another (e.g. external) address.
|
|
113
|
+
|
|
114
|
+
### Changed
|
|
115
|
+
|
|
116
|
+
- New README section "Privacy": the plugin collects no data and only talks to the HEOS devices in the local network.
|
|
117
|
+
- Clearer debug messages for the protocol check, e.g. "AVR Control (port 23) not available (connection refused)" instead of "error for … ECONNREFUSED".
|
|
118
|
+
|
|
119
|
+
## 1.2.4
|
|
120
|
+
|
|
121
|
+
### Changed
|
|
122
|
+
|
|
123
|
+
- 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.
|
|
124
|
+
|
|
125
|
+
1.2.3 was not published on npm; its changes are included in 1.2.4.
|
|
126
|
+
|
|
127
|
+
## 1.2.3
|
|
128
|
+
|
|
129
|
+
### Changed
|
|
130
|
+
|
|
131
|
+
- 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).
|
|
132
|
+
- Documentation: *Apple Home* instead of *HomeKit*; *Compatibility and security* section and badges; troubleshooting for devices that appear offline in the Homebridge UI.
|
|
133
|
+
|
|
134
|
+
### Security / CI
|
|
135
|
+
|
|
136
|
+
- Weekly *Compatibility & CVE check* with homebridge@latest and @beta on Node.js 22, 24 and 26, Dependabot for dependency updates.
|
|
137
|
+
|
|
138
|
+
## 1.2.2
|
|
139
|
+
|
|
140
|
+
### Fixed
|
|
141
|
+
|
|
142
|
+
- 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.
|
|
143
|
+
- 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.
|
|
144
|
+
|
|
145
|
+
## 1.2.1
|
|
146
|
+
|
|
147
|
+
### Fixed
|
|
148
|
+
|
|
149
|
+
- When switching on took a few seconds (e.g. while the power on favorite was being started), the tile briefly showed "off" before it switched to "on". The requested state is now reported from the moment of the tap, and intermediate states of the device are ignored until switching has finished.
|
|
150
|
+
- The player list was requested twice per device at startup.
|
|
151
|
+
|
|
152
|
+
## 1.2.0
|
|
153
|
+
|
|
154
|
+
### New
|
|
155
|
+
|
|
156
|
+
- **Control protocol check at startup:** the plugin checks which protocols a device supports. If the configured protocol isn't supported (e.g. *Hybrid* or *AVR Control* on a Denon Home speaker), it uses a supported one and logs a warning with what to change, instead of the device showing "No Response". A device configured with *HEOS CLI* that also supports AVR Control gets a hint that *Hybrid* is possible. Devices that are switched off at startup keep their configuration.
|
|
157
|
+
- The plugin settings explain which devices support which protocol.
|
|
158
|
+
|
|
159
|
+
### Changed
|
|
160
|
+
|
|
161
|
+
- The protocol support of a device is checked on both ports in parallel (faster startup if a device is offline).
|
|
162
|
+
|
|
163
|
+
## 1.1.2
|
|
164
|
+
|
|
165
|
+
### Fixed
|
|
166
|
+
|
|
167
|
+
- Switching on (HEOS CLI) also starts the HEOS favorite when the speaker reports "paused" but has nothing to play: if the current media is empty, or if the speaker accepts the play command but playback doesn't start within 3 seconds. Seen on a Denon Home Amp after a streaming session.
|
|
168
|
+
|
|
169
|
+
## 1.1.1
|
|
170
|
+
|
|
171
|
+
### Changed
|
|
172
|
+
|
|
173
|
+
- Switching on a speaker that is already playing no longer sends an unnecessary play command.
|
|
174
|
+
- Starting the power on favorite is shown in the normal log (not only in the debug log), e.g. `Nothing to resume, starting HEOS favorite 1.`
|
|
175
|
+
|
|
176
|
+
### Documentation
|
|
177
|
+
|
|
178
|
+
- README: a HEOS favorite is required for switching on without a source; fixed ports and the *Ciao* mDNS advertiser help if devices appear offline in the Homebridge UI after restarts.
|
|
179
|
+
|
|
180
|
+
## 1.1.0
|
|
181
|
+
|
|
182
|
+
### New
|
|
183
|
+
|
|
184
|
+
- **Switching on always plays something (HEOS CLI):** if a speaker has nothing to resume (no active source, e.g. after a restart) or refuses to resume, the first HEOS favorite is started. This makes switching on via scenes and automations reliable. Configurable per device with `powerOnFavorite` (number of the favorite, 0 = disabled).
|
|
185
|
+
|
|
186
|
+
### Fixed
|
|
187
|
+
|
|
188
|
+
- After switching on or off, the tile could briefly jump back to the old state, because devices report the old state for a moment. The new state is now kept for a few seconds, unless the device reports a different change (e.g. from the HEOS app).
|
|
189
|
+
|
|
190
|
+
## 1.0.1
|
|
191
|
+
|
|
192
|
+
### Changed
|
|
193
|
+
|
|
194
|
+
- Releases are built by GitHub Actions and staged on npm with Trusted Publishing and provenance: every version on npm can be traced back to the GitHub commit it was built from, and it only becomes public after approval with 2FA / passkey. Before staging, the workflow checks for known vulnerabilities (`npm audit`) and runs the tests and a compatibility test with the latest Homebridge release.
|
|
195
|
+
- A release is a single command (`npm version x.y.z`); the GitHub release is created automatically with the notes from this changelog ([RELEASING.md](RELEASING.md)).
|
|
196
|
+
- CI also tests with Node.js 26.
|
|
197
|
+
|
|
198
|
+
No changes to the plugin itself.
|
|
199
|
+
|
|
200
|
+
## 1.0.0
|
|
201
|
+
|
|
202
|
+
First release of the fork as `@tplnet/homebridge-denon-heos-audio`.
|
|
203
|
+
Tested with Denon Home 150, Denon Home 250, Denon Home Amp and Marantz Cinema 60 on Homebridge 2.5.0 (and 1.11.4 in automated tests).
|
|
204
|
+
|
|
205
|
+
### New
|
|
206
|
+
|
|
207
|
+
- **Automatic setup:** discovered devices can be added automatically (`autoAddDiscoveredDevices`), with their HEOS name and the best control protocol (Hybrid if supported). Manually configured devices are not affected; single devices can be excluded (`excludedSerialNumbers`).
|
|
208
|
+
- **Inputs read from the device:** with HEOS CLI and Hybrid, the plugin asks the device for its inputs and shows exactly those, with the names set on the device. Before, every device got about 66 input entries.
|
|
209
|
+
- **Marantz support** in device discovery.
|
|
210
|
+
- New device discovery that only asks for HEOS devices, searches every 2 minutes and restarts itself after network errors.
|
|
211
|
+
- Step-by-step guide for adding a device to Apple Home, troubleshooting and a manual test checklist ([TESTING.md](TESTING.md)).
|
|
212
|
+
|
|
213
|
+
### Fixed
|
|
214
|
+
|
|
215
|
+
- Homebridge could crash on unexpected or malformed messages from a device (unhandled errors / promise rejections).
|
|
216
|
+
- Devices with a **negative HEOS player id** (common, e.g. `pid=-1234567890`) did not react at all: all their responses were discarded.
|
|
217
|
+
- The HEOS play state `unknown` (device without active source) was treated as an error, so the power state was shown wrongly.
|
|
218
|
+
- Failed HEOS commands were not recognised (`result` field) and always ran into the timeout.
|
|
219
|
+
- Device discovery stopped forever after the first error of any UPnP device in the network; it could also exhaust the open files of the process (`EMFILE`).
|
|
220
|
+
- Volume limit 0 was ignored; `setVolume` errors were not reported; the play/pause lock could stay set forever.
|
|
221
|
+
- The plugin configuration form in the Homebridge UI could stick to the mouse pointer after using a dropdown.
|
|
222
|
+
- Timers and sockets were not cleaned up; circular module imports.
|
|
223
|
+
|
|
224
|
+
### Changed
|
|
225
|
+
|
|
226
|
+
- Package name `@tplnet/homebridge-denon-heos-audio` (the platform name `DenonHeosAudio` and existing configurations are unchanged).
|
|
227
|
+
- Requires Node.js 22.12+, 24 or 26 (like Homebridge 2.5).
|
|
228
|
+
- Removed the generic SSDP library; fewer dependencies.
|
|
229
|
+
- Discontinued streaming services (Rhapsody, Rdio, MoodMix, Juke) removed.
|
|
230
|
+
- License stated as GPL-3.0 in `package.json`, matching the `LICENSE` file of the original project.
|
|
231
|
+
|
|
232
|
+
### Security
|
|
233
|
+
|
|
234
|
+
- All dependencies updated; `npm audit`: 0 known vulnerabilities.
|
|
235
|
+
- CI checks vulnerabilities (CVEs) and compatibility with the latest Homebridge on every push and weekly.
|