matterbridge-zigbee2mqtt 3.0.2-dev-20251201-a287727 → 3.0.2-dev-20251201-f681e77

package/CHANGELOG.md

@@ -12,6 +12,8 @@ If you like this project and find it useful, please consider giving it a star on
 
 - [scenes]: Added await for creation.
 - [mqtt]: Added config for a fixed clientId. If not provided, a random clientId will be generated. (https://github.com/Luligu/matterbridge-zigbee2mqtt/issues/138)
+- [mqtt]: Added Unix socket: use unix://<SOCKET_PATH> for Unix socket (e.g. unix:///var/run/mqtt.sock). (https://github.com/Luligu/matterbridge-zigbee2mqtt/issues/133)
+- [zigbee2mqtt]: Added frontend package detection. With the new windfront, link or bookmarks to the specific device page are not possible. (https://github.com/Luligu/matterbridge-zigbee2mqtt/issues/136)
 
 ### Changed
 

package/dist/module.js

@@ -48,7 +48,8 @@ export class ZigbeePlatform extends MatterbridgeDynamicPlatform {
         this.shouldConfigure = false;
         if (config.host && typeof config.host === 'string') {
             this.mqttHost = config.host;
-            this.mqttHost = !this.mqttHost.startsWith('mqtt://') && !this.mqttHost.startsWith('mqtts://') ? 'mqtt://' + this.mqttHost : this.mqttHost;
+            this.mqttHost =
+                !this.mqttHost.startsWith('mqtt://') && !this.mqttHost.startsWith('mqtts://') && !this.mqttHost.startsWith('unix://') ? 'mqtt://' + this.mqttHost : this.mqttHost;
         }
         if (config.port)
             this.mqttPort = config.port;
@@ -139,6 +140,8 @@ export class ZigbeePlatform extends MatterbridgeDynamicPlatform {
                 this.log.info(`zigbee2MQTT advanced.legacy_api is ${this.z2mBridgeInfo.config.advanced.legacy_api}`);
             if (this.z2mBridgeInfo.config.advanced.legacy_availability_payload === true)
                 this.log.info(`zigbee2MQTT advanced.legacy_availability_payload is ${this.z2mBridgeInfo.config.advanced.legacy_availability_payload}`);
+            if (this.z2mBridgeInfo.config.frontend?.package)
+                this.log.info(`zigbee2MQTT frontend.package is ${this.z2mBridgeInfo.config.frontend?.package}`);
         });
         this.z2m.on('bridge-devices', async (devices) => {
             if (devices === null || devices === undefined)
@@ -442,7 +445,7 @@ export class ZigbeePlatform extends MatterbridgeDynamicPlatform {
         try {
             matterDevice = await ZigbeeDevice.create(this, device);
             if (matterDevice.bridgedDevice) {
-                matterDevice.bridgedDevice.configUrl = `${this.config.zigbeeFrontend}/#/device/${device.ieee_address}/info`;
+                matterDevice.bridgedDevice.configUrl = `${this.config.zigbeeFrontend}/#/device/${this.z2mBridgeInfo?.config.frontend?.package === 'zigbee2mqtt-frontend' ? '' : '0/'}${device.ieee_address}/info`;
                 await this.registerDevice(matterDevice.bridgedDevice);
                 this.bridgedDevices.push(matterDevice.bridgedDevice);
                 this.zigbeeEntities.push(matterDevice);
@@ -466,7 +469,7 @@ export class ZigbeePlatform extends MatterbridgeDynamicPlatform {
         try {
             matterGroup = await ZigbeeGroup.create(this, group);
             if (matterGroup.bridgedDevice) {
-                matterGroup.bridgedDevice.configUrl = `${this.config.zigbeeFrontend}/#/group/${group.id}`;
+                matterGroup.bridgedDevice.configUrl = `${this.config.zigbeeFrontend}/#/group/${this.z2mBridgeInfo?.config.frontend?.package === 'zigbee2mqtt-frontend' ? '' : '0/'}${group.id}`;
                 await this.registerDevice(matterGroup.bridgedDevice);
                 this.bridgedDevices.push(matterGroup.bridgedDevice);
                 this.zigbeeEntities.push(matterGroup);

package/dist/zigbee2mqtt.js

@@ -99,6 +99,18 @@ export class Zigbee2MQTT extends EventEmitter {
                 this.log.warn('You are using mqtt:// protocol, but you provided a key. It will be ignored.');
             }
         }
+        else if (mqttHost.startsWith('unix://')) {
+            this.log.debug('Using unix:// protocol for MQTT connection over Unix socket');
+            if (ca) {
+                this.log.warn('You are using unix:// protocol, but you provided a CA certificate. It will be ignored.');
+            }
+            if (cert) {
+                this.log.warn('You are using unix:// protocol, but you provided a certificate. It will be ignored.');
+            }
+            if (key) {
+                this.log.warn('You are using unix:// protocol, but you provided a key. It will be ignored.');
+            }
+        }
         else {
             this.log.warn('You are using an unsupported MQTT protocol. Please use mqtt:// or mqtts://.');
         }
@@ -149,7 +161,7 @@ export class Zigbee2MQTT extends EventEmitter {
         }
     }
     getUrl() {
-        return this.mqttHost + ':' + this.mqttPort.toString();
+        return this.mqttHost.startsWith('unix://') ? this.mqttHost : this.mqttHost + ':' + this.mqttPort.toString();
     }
     async start() {
         this.log.debug(`Starting connection to ${this.getUrl()}...`);

package/matterbridge-zigbee2mqtt.schema.json

@@ -17,7 +17,7 @@
       "ui:widget": "hidden"
     },
     "host": {
-      "description": "MQTT server host (IP address or hostname with mqtt:// or mqtts:// prefix). For secure connections, use the mqtts:// prefix and ensure your certificates are configured. If you use a hostname, make sure that the hostname is resolvable by the system running matterbridge.",
+      "description": "MQTT server host (IP address or hostname with mqtt:// or mqtts:// prefix) or unix://<SOCKET_PATH> for Unix socket (e.g. unix:///var/run/mqtt.sock). For secure connections, use the mqtts:// prefix and ensure your certificates are configured. If you use a hostname, make sure that the hostname is resolvable by the system running matterbridge.",
       "type": "string",
       "default": "mqtt://localhost"
     },

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-zigbee2mqtt",
-  "version": "3.0.2-dev-20251201-a287727",
+  "version": "3.0.2-dev-20251201-f681e77",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-zigbee2mqtt",
-      "version": "3.0.2-dev-20251201-a287727",
+      "version": "3.0.2-dev-20251201-f681e77",
       "license": "Apache-2.0",
       "dependencies": {
         "moment": "2.30.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-zigbee2mqtt",
-  "version": "3.0.2-dev-20251201-a287727",
+  "version": "3.0.2-dev-20251201-f681e77",
   "description": "Matterbridge zigbee2mqtt plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",