matterbridge 3.5.1-dev-20260122-6461be3 → 3.5.1-dev-20260123-c42b5cf

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.
Files changed (5) hide show
  1. package/CHANGELOG.md +2 -0
  2. package/README.md +41 -7
  3. package/dist/frontend.js +5 -1
  4. package/npm-shrinkwrap.json +48 -48
  5. package/package.json +5 -5
package/CHANGELOG.md CHANGED
@@ -37,8 +37,10 @@ Advantages:
37
37
  - [workflows]: Added concurrency settings in build.yml to cancel previous runs in GitHub Actions.
38
38
  - [preset]: Added Thermostat with preset feature. Thanks Ludovic BOUÉ (https://github.com/Luligu/matterbridge/pull/482).
39
39
  - [matter.js]: Bump to matter.j v. 0.16.6.
40
+ - [matter.js]: Bump to matter.j v. 0.16.7.
40
41
  - [mb_mdns]: Added --ip-filter params to filter incoming mDns messages by sender ip.
41
42
  - [express]: Added a login check for internal express api. Now only /health and /memory are opened. Thanks Rogibaer (https://github.com/Luligu/matterbridge-hass/issues/149).
43
+ - [readme]: Added a section with the data structure and backup/restore guidelines.
42
44
 
43
45
  ### Changed
44
46
 
package/README.md CHANGED
@@ -162,7 +162,13 @@ Here's how to specify a different port number:
162
162
  matterbridge --frontend [port number]
163
163
  ```
164
164
 
165
- To use the frontend with ssl see below.
165
+ The frontend binds, by default, to all IPv4 and IPv6 addresses. You can override this and bind to a specific address:
166
+
167
+ ```bash
168
+ matterbridge --bind [address]
169
+ ```
170
+
171
+ To use the frontend with SSL, see below.
166
172
 
167
173
  From the frontend you can do all operations in an easy way.
168
174
 
@@ -551,6 +557,37 @@ So depending on the controller you pair with, you should see 100 for fully close
551
557
 
552
558
  Some controllers invert the position so you need to verify your controller.
553
559
 
560
+ ## Data structure
561
+
562
+ Matterbridge uses three directories. These are the default locations (some advanced setups may change them, so check your configuration):
563
+
564
+ ```text
565
+ ~/.matterbridge
566
+ ~/Matterbridge
567
+ ~/.mattercert
568
+ ```
569
+
570
+ ### Backup
571
+
572
+ From the frontend (three-dots menu), select **Create backup**, then **Download backup** when it is ready.
573
+ The backup file is a standard `.zip` archive.
574
+
575
+ ### Restore
576
+
577
+ Restore must be done manually because the archive paths depend on your setup.
578
+
579
+ Make sure Matterbridge is not running. Stop it if needed.
580
+
581
+ Extract the backup and replace the corresponding directories on your system with the ones from the backup:
582
+
583
+ ```text
584
+ .matterbridge
585
+ Matterbridge
586
+ .mattercert
587
+ ```
588
+
589
+ Ensure permissions are correct for the restored directories.
590
+
554
591
  # Known general issues
555
592
 
556
593
  ## Session XYZ does not exist or Cannot find a session for ID XYZ
@@ -567,17 +604,13 @@ All issues have been solved from the version 17.5 of the HomePod/AppleTV. Now th
567
604
 
568
605
  If you have more then one Apple TV or Home Pod, you can herve better results setting to disabled "Automatic Selection" in "Home Setting", "Home Hubs & Bridges". When "Automatic selection" is disabled, select your Apple Tv if you have one or any of your Home Pod. In this way you should not have anymore more then one session for fabric.
569
606
 
570
- ### Manufacturer Serial Number and Model
571
-
572
- The Home app forgets about them when you restart the node.
573
-
574
607
  ### Appliances
575
608
 
576
609
  As of version 18.4.x, all Appliances device types are not supported by the Home app. They don't even appear like unsupported accessories.
577
610
 
578
611
  ### Robot
579
612
 
580
- As of version 18.4.x, the Robot is supported by the Home app only as a single, non-bridged device or if it is the only device in the bridge.
613
+ As of version 18.4.x, the Robot is supported by the Home app only as a single, non-bridged device or if it is the only device in the bridge. Furthermore the device cannot be a composed device. The only device type supported is the rvc.
581
614
 
582
615
  If a Robot is present alongside other devices in the bridge, the entire bridge becomes unstable in the Home app.
583
616
 
@@ -591,7 +624,6 @@ So far is the only controller supporting all Matter 1.2, 1.3 and 1.4 device type
591
624
 
592
625
  - If HA doesn't show all devices, reload the Matter Server Integration or reboot HA
593
626
  - Home Assistant doesn't seem to always react when a device is removed from the bridge: they remain in HA unavailable forever. A full Home Assistant restart solves the problem.
594
- - Use Apple Home when you have to choose the controller type even if you pair Matterbridge directly with HA.
595
627
 
596
628
  ## Google Home
597
629
 
@@ -601,6 +633,8 @@ If you face a problem changing the brightness check this for the explanation: ht
601
633
 
602
634
  If you encounter a “Something Went Wrong” screen while commissioning MatterBridge devices in Google Home on Android, it’s due to an Android bug. Android fails to send the country code, which is mandatory under the Matter specification.
603
635
 
636
+ There is also a known issue with the thermostat Fahrenheit to Celsius Conversion (https://github.com/Luligu/matterbridge/issues/462).
637
+
604
638
  ### Workaround
605
639
 
606
640
  Install Google Home on an iPhone and complete the commissioning there. Once set up, the devices will appear and function normally on your Android phone and other Nest devices in your home. By [Artem Kovalov](https://github.com/artemkovalyov).
package/dist/frontend.js CHANGED
@@ -238,6 +238,8 @@ export class Frontend extends EventEmitter {
238
238
  return socket.destroy();
239
239
  }
240
240
  this.log.debug(`WebSocket upgrade success host ${url.host} password ${password ? '[redacted]' : '(empty)'}`);
241
+ if (req.socket.remoteAddress)
242
+ this.authClients.push(req.socket.remoteAddress);
241
243
  this.webSocketServer?.handleUpgrade(req, socket, head, (ws) => {
242
244
  this.webSocketServer?.emit('connection', ws, req);
243
245
  });
@@ -373,6 +375,8 @@ export class Frontend extends EventEmitter {
373
375
  return socket.destroy();
374
376
  }
375
377
  this.log.debug(`WebSocket upgrade success host ${url.host} password ${password ? '[redacted]' : '(empty)'}`);
378
+ if (req.socket.remoteAddress)
379
+ this.authClients.push(req.socket.remoteAddress);
376
380
  this.webSocketServer?.handleUpgrade(req, socket, head, (ws) => {
377
381
  this.webSocketServer?.emit('connection', ws, req);
378
382
  });
@@ -1484,7 +1488,7 @@ export class Frontend extends EventEmitter {
1484
1488
  else if (data.method === '/api/create-backup') {
1485
1489
  this.wssSendSnackbarMessage('Creating backup...', 0);
1486
1490
  this.log.notice(`Creating the backup...`);
1487
- await createZip(path.join(os.tmpdir(), `matterbridge.backup.zip`), path.join(this.matterbridge.matterbridgeDirectory), path.join(this.matterbridge.matterbridgePluginDirectory));
1491
+ await createZip(path.join(os.tmpdir(), `matterbridge.backup.zip`), path.join(this.matterbridge.matterbridgeDirectory), path.join(this.matterbridge.matterbridgePluginDirectory), path.join(this.matterbridge.matterbridgeCertDirectory));
1488
1492
  this.log.notice(`Backup ready to be downloaded.`);
1489
1493
  this.wssSendCloseSnackbarMessage('Creating backup...');
1490
1494
  this.wssSendSnackbarMessage('Backup ready to be downloaded', 10);
package/npm-shrinkwrap.json CHANGED
@@ -1,16 +1,16 @@
1
1
  {
2
2
  "name": "matterbridge",
3
- "version": "3.5.1-dev-20260122-6461be3",
3
+ "version": "3.5.1-dev-20260123-c42b5cf",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "matterbridge",
9
- "version": "3.5.1-dev-20260122-6461be3",
9
+ "version": "3.5.1-dev-20260123-c42b5cf",
10
10
  "license": "Apache-2.0",
11
11
  "dependencies": {
12
- "@matter/main": "0.16.6",
13
- "@matterbridge/dgram": "0.0.2",
12
+ "@matter/main": "0.16.7",
13
+ "@matterbridge/dgram": "0.0.3",
14
14
  "@matterbridge/jest-utils": "0.0.1",
15
15
  "@matterbridge/utils": "0.0.1",
16
16
  "@matterbridge/vitest-utils": "0.0.1",
@@ -74,92 +74,92 @@
74
74
  }
75
75
  },
76
76
  "node_modules/@matter/general": {
77
- "version": "0.16.6",
78
- "resolved": "https://registry.npmjs.org/@matter/general/-/general-0.16.6.tgz",
79
- "integrity": "sha512-MyMLj9MEk6e0J+qjFVxuNxySTy2RcjdtYog7d9xGrWWI1mszCiT61Q5/aE198z+v5+Lca8CX+GDfeoNIT6hdgw==",
77
+ "version": "0.16.7",
78
+ "resolved": "https://registry.npmjs.org/@matter/general/-/general-0.16.7.tgz",
79
+ "integrity": "sha512-b2JzhArkGm01vx/8NMo8KDAuffg0zeEcljW0bL2lWXcNiG/bFo/qDwrttZXO2igtej8OlA3yRih0DWX32SQkIQ==",
80
80
  "license": "Apache-2.0",
81
81
  "dependencies": {
82
82
  "@noble/curves": "^2.0.1"
83
83
  }
84
84
  },
85
85
  "node_modules/@matter/main": {
86
- "version": "0.16.6",
87
- "resolved": "https://registry.npmjs.org/@matter/main/-/main-0.16.6.tgz",
88
- "integrity": "sha512-QTShS4OVEXoDyjI7jeLx35EPNUho8V/RZu971aBoHU3ueIxj4/gPWecN5NBTsmEl2VaCKHnmNaT6z11lNgdIaA==",
86
+ "version": "0.16.7",
87
+ "resolved": "https://registry.npmjs.org/@matter/main/-/main-0.16.7.tgz",
88
+ "integrity": "sha512-qRamX7AQyDqBOPchM1d0ghjXcUyxcuMJjfsJN+ob7DtHpdQcZ0rTR6uSfuf2AFB2IzV5HSIrCSeraG4AEFcloA==",
89
89
  "license": "Apache-2.0",
90
90
  "dependencies": {
91
- "@matter/general": "0.16.6",
92
- "@matter/model": "0.16.6",
93
- "@matter/node": "0.16.6",
94
- "@matter/protocol": "0.16.6",
95
- "@matter/types": "0.16.6"
91
+ "@matter/general": "0.16.7",
92
+ "@matter/model": "0.16.7",
93
+ "@matter/node": "0.16.7",
94
+ "@matter/protocol": "0.16.7",
95
+ "@matter/types": "0.16.7"
96
96
  },
97
97
  "optionalDependencies": {
98
- "@matter/nodejs": "0.16.6"
98
+ "@matter/nodejs": "0.16.7"
99
99
  }
100
100
  },
101
101
  "node_modules/@matter/model": {
102
- "version": "0.16.6",
103
- "resolved": "https://registry.npmjs.org/@matter/model/-/model-0.16.6.tgz",
104
- "integrity": "sha512-eTLer9EibjA87AKn1Kj/oQv3nabaWJ2Pns3bGCUbgVycgGkLELJQs8TiA2QqorGbH2upTFmYfyaVUoxtMtyHbA==",
102
+ "version": "0.16.7",
103
+ "resolved": "https://registry.npmjs.org/@matter/model/-/model-0.16.7.tgz",
104
+ "integrity": "sha512-zjsKz9DX39IVXOydoibyh4RIHVed+fkBSJ/m7VhIchbsHdiPjx2n3b4vuexDh/ToPkOVePRuKjKW8QluhgPk6Q==",
105
105
  "license": "Apache-2.0",
106
106
  "dependencies": {
107
- "@matter/general": "0.16.6"
107
+ "@matter/general": "0.16.7"
108
108
  }
109
109
  },
110
110
  "node_modules/@matter/node": {
111
- "version": "0.16.6",
112
- "resolved": "https://registry.npmjs.org/@matter/node/-/node-0.16.6.tgz",
113
- "integrity": "sha512-gPmxxX9OG4QnAPHdQsSbs1B/gB5WIrCaTkjp/kqLKCYWuYtFbDQr+PXTWn7SdQZWY/aHZ9/e3xP4VeVd8sk4/A==",
111
+ "version": "0.16.7",
112
+ "resolved": "https://registry.npmjs.org/@matter/node/-/node-0.16.7.tgz",
113
+ "integrity": "sha512-qM7NN1RvyvaNE6BC0ZrqpOdrzINJLTojDdkYT3BQcH4q+qE3CvnYlm+IeZa4vDOxC9FViUJ1tx7LQajWoVFBXA==",
114
114
  "license": "Apache-2.0",
115
115
  "dependencies": {
116
- "@matter/general": "0.16.6",
117
- "@matter/model": "0.16.6",
118
- "@matter/protocol": "0.16.6",
119
- "@matter/types": "0.16.6"
116
+ "@matter/general": "0.16.7",
117
+ "@matter/model": "0.16.7",
118
+ "@matter/protocol": "0.16.7",
119
+ "@matter/types": "0.16.7"
120
120
  }
121
121
  },
122
122
  "node_modules/@matter/nodejs": {
123
- "version": "0.16.6",
124
- "resolved": "https://registry.npmjs.org/@matter/nodejs/-/nodejs-0.16.6.tgz",
125
- "integrity": "sha512-r4UgxNWEsOCan315Bne3k1n3KFExBW5k263wGsef6a1GViJdjAAx4IhO6GxXtPH+bPFsjYQO4N7AZ5BCR8Knqw==",
123
+ "version": "0.16.7",
124
+ "resolved": "https://registry.npmjs.org/@matter/nodejs/-/nodejs-0.16.7.tgz",
125
+ "integrity": "sha512-fL5i9Cxga6JqFj7+dpc6dfWh2XvYvsVD9VLxe1wUuBD58vxQ6lXqx9RbUebbDJ5BqhLgZNcnpJQgEI4ziV1Bww==",
126
126
  "license": "Apache-2.0",
127
127
  "optional": true,
128
128
  "dependencies": {
129
- "@matter/general": "0.16.6",
130
- "@matter/node": "0.16.6",
131
- "@matter/protocol": "0.16.6",
132
- "@matter/types": "0.16.6"
129
+ "@matter/general": "0.16.7",
130
+ "@matter/node": "0.16.7",
131
+ "@matter/protocol": "0.16.7",
132
+ "@matter/types": "0.16.7"
133
133
  },
134
134
  "engines": {
135
135
  "node": ">=20.19.0 <22.0.0 || >=22.13.0"
136
136
  }
137
137
  },
138
138
  "node_modules/@matter/protocol": {
139
- "version": "0.16.6",
140
- "resolved": "https://registry.npmjs.org/@matter/protocol/-/protocol-0.16.6.tgz",
141
- "integrity": "sha512-Mw5F+TZrlcrofsH84Jc1F2tldn0tLRFDVC9s5d1cwUh5196xlSyapuFGKA2TdDgjS7jSZvcMsOutSVUlVtpgqw==",
139
+ "version": "0.16.7",
140
+ "resolved": "https://registry.npmjs.org/@matter/protocol/-/protocol-0.16.7.tgz",
141
+ "integrity": "sha512-wPBug0Yr401Mw7l6WYb3Kw/Uvwl68Sky6nVcWwaPMZtFepd7+uDpJ2SLyvuCpRsv0T8+O/VhN0y1FNybJxiivA==",
142
142
  "license": "Apache-2.0",
143
143
  "dependencies": {
144
- "@matter/general": "0.16.6",
145
- "@matter/model": "0.16.6",
146
- "@matter/types": "0.16.6"
144
+ "@matter/general": "0.16.7",
145
+ "@matter/model": "0.16.7",
146
+ "@matter/types": "0.16.7"
147
147
  }
148
148
  },
149
149
  "node_modules/@matter/types": {
150
- "version": "0.16.6",
151
- "resolved": "https://registry.npmjs.org/@matter/types/-/types-0.16.6.tgz",
152
- "integrity": "sha512-QUuFNJPKVj4pwudH1dX5UQx+WLGqUq2Gxg5ZMrOidWAl7jElucMJWEwMLVGDfL1vq6XXzGH5oxV2l+mVdcx2mQ==",
150
+ "version": "0.16.7",
151
+ "resolved": "https://registry.npmjs.org/@matter/types/-/types-0.16.7.tgz",
152
+ "integrity": "sha512-eQrzYJOzdFy8gwA9cp+wsDHfc6q5iuAHf3Ir4xSkxp+zR75xIYYyavCPVncT4f3Su4nxikz6EXblIgPXUUP01g==",
153
153
  "license": "Apache-2.0",
154
154
  "dependencies": {
155
- "@matter/general": "0.16.6",
156
- "@matter/model": "0.16.6"
155
+ "@matter/general": "0.16.7",
156
+ "@matter/model": "0.16.7"
157
157
  }
158
158
  },
159
159
  "node_modules/@matterbridge/dgram": {
160
- "version": "0.0.2",
161
- "resolved": "https://registry.npmjs.org/@matterbridge/dgram/-/dgram-0.0.2.tgz",
162
- "integrity": "sha512-XNsAk3KSGner3LvtIOkCGC31kk5qXmSPOEFHv4wDry+iorXzA15+PCfc8f/v5C+v1eCNdCXPBpxyNLAPJWcC5Q==",
160
+ "version": "0.0.3",
161
+ "resolved": "https://registry.npmjs.org/@matterbridge/dgram/-/dgram-0.0.3.tgz",
162
+ "integrity": "sha512-NMMIWRDjRC574c0weQoERmGlwayaJKAkR5mCb/dDMSYf6JyhN0QPQuqcWBzy7EG8Zl4jI99QdnmzLL0xFnJH+A==",
163
163
  "license": "Apache-2.0",
164
164
  "dependencies": {
165
165
  "@matterbridge/jest-utils": "0.0.1",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "matterbridge",
3
- "version": "3.5.1-dev-20260122-6461be3",
3
+ "version": "3.5.1-dev-20260123-c42b5cf",
4
4
  "description": "Matterbridge plugin manager for Matter",
5
5
  "author": "https://github.com/Luligu",
6
6
  "license": "Apache-2.0",
@@ -104,8 +104,8 @@
104
104
  }
105
105
  },
106
106
  "dependencies": {
107
- "@matter/main": "0.16.6",
108
- "@matterbridge/dgram": "0.0.2",
107
+ "@matter/main": "0.16.7",
108
+ "@matterbridge/dgram": "0.0.3",
109
109
  "@matterbridge/jest-utils": "0.0.1",
110
110
  "@matterbridge/utils": "0.0.1",
111
111
  "@matterbridge/vitest-utils": "0.0.1",
@@ -118,8 +118,8 @@
118
118
  "ws": "8.19.0"
119
119
  },
120
120
  "build": {
121
- "sha": "6461be3ccab30eba315d06587206f5ca5dcdc344",
122
- "sha7": "6461be3",
121
+ "sha": "c42b5cf5f03aabba85120ce3118485b9a5a0d359",
122
+ "sha7": "c42b5cf",
123
123
  "event": "workflow_dispatch",
124
124
  "workflow": "Daily Dev Publish to npm",
125
125
  "type": "branch",