homebridge-broadlink-rm-blaster 1.1.1 → 1.2.0
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 +66 -0
- package/README.md +40 -31
- package/package.json +5 -2
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
All notable changes to this project will be documented in this file.
|
|
3
|
+
|
|
4
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
5
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
|
+
|
|
7
|
+
## Unreleased
|
|
8
|
+
|
|
9
|
+
## [1.2.0] - 2026-07-26
|
|
10
|
+
|
|
11
|
+
### Changed
|
|
12
|
+
- `package.json`'s `files` list now explicitly includes README, LICENSE and
|
|
13
|
+
CHANGELOG alongside the published `dist` output.
|
|
14
|
+
- README restructured: Requirements/Installation/Usage sections, version
|
|
15
|
+
number in the title, Features/Configuration/Debugging nested under Usage,
|
|
16
|
+
license/changelog links at the bottom.
|
|
17
|
+
|
|
18
|
+
## [1.1.1] - 2026-07-26
|
|
19
|
+
|
|
20
|
+
### Added
|
|
21
|
+
- Temperature/humidity sensor now shows "No Response" in Home and sends an
|
|
22
|
+
ntfy notification after 5 consecutive failed readings, instead of silently
|
|
23
|
+
keeping the last known value forever.
|
|
24
|
+
|
|
25
|
+
## [1.1.0] - 2026-07-25
|
|
26
|
+
|
|
27
|
+
### Added
|
|
28
|
+
- Optional `ntfyTopic` config field: sends a push notification via ntfy.sh
|
|
29
|
+
the first time an RM device fails to connect.
|
|
30
|
+
|
|
31
|
+
## [1.0.4] - 2026-07-23
|
|
32
|
+
|
|
33
|
+
### Changed
|
|
34
|
+
- Reverted the `.npmignore` added in 1.0.3 (inert; `package.json`'s `files`
|
|
35
|
+
field already controls what's published).
|
|
36
|
+
|
|
37
|
+
## [1.0.3] - 2026-07-23
|
|
38
|
+
|
|
39
|
+
### Added
|
|
40
|
+
- `.npmignore`.
|
|
41
|
+
|
|
42
|
+
## [1.0.2] - 2026-07-22
|
|
43
|
+
|
|
44
|
+
### Fixed
|
|
45
|
+
- Reverted 1.0.1's per-IP placeholder MAC (broke authentication with real
|
|
46
|
+
Broadlink hardware); fixed the underlying multi-device registry collision
|
|
47
|
+
with a private `Broadlink` instance per configured RM device instead.
|
|
48
|
+
|
|
49
|
+
## [1.0.1] - 2026-07-22
|
|
50
|
+
|
|
51
|
+
### Fixed
|
|
52
|
+
- Second configured RM device permanently failing to authenticate, and a
|
|
53
|
+
`MaxListenersExceededWarning` on repeated connection retries.
|
|
54
|
+
|
|
55
|
+
## [1.0.0] - 2026-07-20
|
|
56
|
+
|
|
57
|
+
### Added
|
|
58
|
+
- First public release: basic accessories (light/switch/outlet/fan), dimmer
|
|
59
|
+
lights with brightness levels, TV remote accessory, temperature/humidity
|
|
60
|
+
sensor, multi-RM-device support, CLI diagnostic tool.
|
|
61
|
+
|
|
62
|
+
## [0.9.1] - 2026-07-20
|
|
63
|
+
|
|
64
|
+
### Changed
|
|
65
|
+
- README restructured: configuration section now leads with Homebridge
|
|
66
|
+
Config UI X support, `config.json` example moved to its own subsection.
|
package/README.md
CHANGED
|
@@ -1,42 +1,30 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Homebridge Broadlink RM Blaster Plugin 1.2.0
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
[homebridge-broadlink-rm](https://github.com/kiwi-cam/homebridge-broadlink-rm#readme),
|
|
5
|
-
built on [kiwicam-broadlinkjs-rm](https://www.npmjs.com/package/kiwicam-broadlinkjs-rm)
|
|
6
|
-
for the underlying device communication.
|
|
3
|
+
**This Homebridge plugin has been 100% vibe coded with Claude.**
|
|
7
4
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
remotes, see
|
|
5
|
+
Blast RF and IR signals from Broadlink RM devices using Homebridge. Sends
|
|
6
|
+
pre-recorded hex codes to a known device IP; does not learn signals or
|
|
7
|
+
autodiscover devices. To capture hex codes from your own remotes, see
|
|
8
|
+
[learn-broadlink-rm4-codes](https://github.com/LuudJacobs/learn-broadlink-rm4-codes).
|
|
11
9
|
|
|
12
|
-
|
|
10
|
+
## Requirements
|
|
13
11
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
-
|
|
17
|
-
|
|
18
|
-
- **Basic accessories** power on/off via a hex signal.
|
|
19
|
-
- **Dimmer lights** one hex signal per discrete brightness level
|
|
20
|
-
- **TVs** power on/off plus a usable remote (arrows, select, back, exit, info,
|
|
21
|
-
volume, mute) in the iOS Remote app
|
|
22
|
-
- **Temperature/humidity sensor** polls the RM every 60 seconds, on by default.
|
|
23
|
-
- **ntfy.sh notifications** optional push notification the first time an RM
|
|
24
|
-
device fails to connect.
|
|
25
|
-
- Fully configurable via the Homebridge Config UI X plugin settings form.
|
|
12
|
+
- A Broadlink RM device, unlocked using the official Broadlink app (new
|
|
13
|
+
devices ship locked, which blocks local API access).
|
|
14
|
+
- Node.js `^18.15.0 || ^20.7.0 || ^22 || ^24`
|
|
15
|
+
- Homebridge `^1.8.0 || ^2.0.0`
|
|
26
16
|
|
|
27
|
-
##
|
|
17
|
+
## Installation
|
|
28
18
|
|
|
29
19
|
```bash
|
|
30
20
|
npm install -g homebridge-broadlink-rm-blaster
|
|
31
21
|
```
|
|
32
22
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
Your Broadlink RM must be unlocked using the official Broadlink app before this
|
|
36
|
-
plugin (or any third-party integration) can control it: new devices ship locked,
|
|
37
|
-
which blocks local API access.
|
|
23
|
+
## Usage
|
|
38
24
|
|
|
39
|
-
|
|
25
|
+
This plugin can be fully configured from the Homebridge Config UI X plugin
|
|
26
|
+
settings form. See [Configuration](#configuration) below for the full field
|
|
27
|
+
reference and an example `config.json`.
|
|
40
28
|
|
|
41
29
|
**TVs don't appear automatically alongside your other accessories.** HomeKit
|
|
42
30
|
only shows a proper TV tile/remote when it's added as its own accessory, so
|
|
@@ -47,12 +35,25 @@ code, the same way you'd add any other HomeKit accessory. If you remove a
|
|
|
47
35
|
TV from your config later, it has to be removed from the Home app manually
|
|
48
36
|
too since Homebridge can't unpair it for you.
|
|
49
37
|
|
|
50
|
-
|
|
38
|
+
### Features
|
|
39
|
+
|
|
40
|
+
- **Multiple RM devices** configure several Broadlink RMs and assign each
|
|
41
|
+
accessory to whichever one it's actually near.
|
|
42
|
+
- **Basic accessories** power on/off via a hex signal.
|
|
43
|
+
- **Dimmer lights** one hex signal per discrete brightness level
|
|
44
|
+
- **TVs** power on/off plus a usable remote (arrows, select, back, exit, info,
|
|
45
|
+
volume, mute) in the iOS Remote app
|
|
46
|
+
- **Temperature/humidity sensor** polls the RM every 60 seconds, on by default.
|
|
47
|
+
- **ntfy.sh notifications** optional push notification the first time an RM
|
|
48
|
+
device fails to connect.
|
|
49
|
+
- Fully configurable via the Homebridge Config UI X plugin settings form.
|
|
50
|
+
|
|
51
|
+
### Configuration
|
|
51
52
|
|
|
52
53
|
This plugin can be fully configured from the Homebridge Config UI X plugin
|
|
53
54
|
settings form.
|
|
54
55
|
|
|
55
|
-
|
|
56
|
+
#### config.json
|
|
56
57
|
|
|
57
58
|
If you'd rather edit the config file directly, here's an example
|
|
58
59
|
`config.json` platform block:
|
|
@@ -162,7 +163,7 @@ If you'd rather edit the config file directly, here's an example
|
|
|
162
163
|
`muteCode` is sent as-is for both muting and unmuting, since most remotes
|
|
163
164
|
use a single toggle button rather than distinct on/off signals.
|
|
164
165
|
|
|
165
|
-
|
|
166
|
+
### Debugging
|
|
166
167
|
|
|
167
168
|
To send a single hex code straight to your RM, bypassing Homebridge/HomeKit
|
|
168
169
|
entirely (useful for isolating whether a signal behaves oddly on the device
|
|
@@ -174,3 +175,11 @@ broadlink-rm-blaster <ip> <hexCode>
|
|
|
174
175
|
```
|
|
175
176
|
|
|
176
177
|
Run `broadlink-rm-blaster --help` for usage details.
|
|
178
|
+
|
|
179
|
+
## Credits
|
|
180
|
+
|
|
181
|
+
Inspired by [homebridge-broadlink-rm](https://github.com/kiwi-cam/homebridge-broadlink-rm#readme),
|
|
182
|
+
built on [kiwicam-broadlinkjs-rm](https://www.npmjs.com/package/kiwicam-broadlinkjs-rm)
|
|
183
|
+
for the underlying device communication.
|
|
184
|
+
|
|
185
|
+
[LICENSE](https://github.com/LuudJacobs/homebridge-broadlink-rm-blaster/blob/main/LICENSE) · [CHANGELOG](https://github.com/LuudJacobs/homebridge-broadlink-rm-blaster/blob/main/CHANGELOG.md)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "homebridge-broadlink-rm-blaster",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "Blast RF and IR signals from Broadlink RM devices using Homebridge",
|
|
5
5
|
"author": "Luud Jacobs",
|
|
6
6
|
"license": "MIT",
|
|
@@ -22,7 +22,10 @@
|
|
|
22
22
|
},
|
|
23
23
|
"files": [
|
|
24
24
|
"dist",
|
|
25
|
-
"config.schema.json"
|
|
25
|
+
"config.schema.json",
|
|
26
|
+
"README.md",
|
|
27
|
+
"LICENSE",
|
|
28
|
+
"CHANGELOG.md"
|
|
26
29
|
],
|
|
27
30
|
"keywords": [
|
|
28
31
|
"homebridge",
|