matterbridge 3.4.4-dev-20251216-3e9ec5b → 3.4.4-dev-20251217-8b8b1cd

package/CHANGELOG.md

@@ -32,12 +32,13 @@ Advantages:
 
 ### Added
 
-- [frontend]: Set autoScroll to false in mobileMode.
+- [frontend]: Set automatically autoScroll to false in mobileMode.
 - [frontend]: Added Log length: 100, 200, 500, 1000.
-- [frontend]: Added Log search with case-insensitive regex: use /text/ in the search field.
+- [frontend]: Added Log search with case-insensitive regex: use /regex/ in the search field to activate the regex search mode (i.e. /Frontend/). See [Regex](https://github.com/Luligu/matterbridge/tree/dev?tab=readme-ov-file#how-to-use-the-regex-search-in-the-log-page).
 - [frontend]: Differentiated update icon color: primary color for latest and secondary color for dev.
-- [frontend]: Added `Reset the frontend UI` in the Reset menu. It will reset the frontend local storage to the default.
-- [MbfTable]: Added ConditionalTooltip to show clipped column cells. Used in the Cluster table.
+- [frontend]: Added `Reset the frontend UI` in the Reset menu. It will reset the frontend local storage to the default and reload the page.
+- [MbfTable]: Added ConditionalTooltip to show clipped column cells. Used in the Cluster table for a better user experience.
+- [frontend]: Added battery level to Devices panel in the Home page. Thanks [Tamer Salah](https://github.com/tammeryousef1006).
 
 ### Changed
 
@@ -48,6 +49,7 @@ Advantages:
 
 - [doorLock]: Fixed DoorLock.supportedOperatingModes. Thanks Ludovic BOUÉ (https://github.com/Luligu/matterbridge/issues/454).
 - [frontend]: Fixed mobileMode menu navigation. Thanks Calimerorulez (https://github.com/Luligu/matterbridge/issues/457).
+- [matterbridge]: Fixed debug level of matter logger.
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
 

package/README.md

@@ -520,6 +520,19 @@ To solve the race condition on blackout, use the --delay parameter. There is no
 
 To solve the race condition on docker compose, use the --fixed_delay parameter. The start will always be delayed so use it only if strictly necessary.
 
+## How to use the regex search in the Log page
+
+The regex search is activated when the search string starts with `/` and ends with `/`.
+
+Examples:
+
+```text
+/^error/          -> match log names (the part with [...]) or lines that start with "error"
+/timeout/         -> match "timeout" anywhere in the line (beginning/middle/end)
+/disconnected$/   -> match lines that end with "disconnected"
+/error|warning/   -> match either "error" OR "warning" (double search)
+```
+
 # Known general issues
 
 ## Session XYZ does not exist or Cannot find a session for ID XYZ

package/dist/frontend.js

@@ -163,11 +163,11 @@ export class Frontend extends EventEmitter {
                 this.wsMessageHandler(ws, message);
             });
             ws.on('ping', () => {
-                this.log.debug('WebSocket client ping');
+                this.log.debug('WebSocket client ping received');
                 ws.pong();
             });
             ws.on('pong', () => {
-                this.log.debug('WebSocket client pong');
+                this.log.debug('WebSocket client pong received');
             });
             ws.on('close', () => {
                 this.log.info('WebSocket client disconnected');
@@ -836,7 +836,7 @@ export class Frontend extends EventEmitter {
     }
     getPowerSource(endpoint) {
         if (this.matterbridge.hasCleanupStarted)
-            return;
+            return undefined;
         if (!endpoint.lifecycle.isReady || endpoint.construction.status !== Lifecycle.Status.Active)
             return undefined;
         const powerSource = (device) => {
@@ -858,6 +858,26 @@ export class Frontend extends EventEmitter {
                 return powerSource(child);
         }
     }
+    getBatteryLevel(endpoint) {
+        if (this.matterbridge.hasCleanupStarted)
+            return undefined;
+        if (!endpoint.lifecycle.isReady || endpoint.construction.status !== Lifecycle.Status.Active)
+            return undefined;
+        const batteryLevel = (device) => {
+            const featureMap = device.getAttribute(PowerSource.Cluster.id, 'featureMap');
+            if (featureMap.battery) {
+                const batChargeLevel = device.getAttribute(PowerSource.Cluster.id, 'batPercentRemaining');
+                return isValidNumber(batChargeLevel) ? batChargeLevel / 2 : undefined;
+            }
+            return undefined;
+        };
+        if (endpoint.hasClusterServer(PowerSource.Cluster.id))
+            return batteryLevel(endpoint);
+        for (const child of endpoint.getChildEndpoints()) {
+            if (child.hasClusterServer(PowerSource.Cluster.id))
+                return batteryLevel(child);
+        }
+    }
     getClusterTextFromDevice(device) {
         if (this.matterbridge.hasCleanupStarted)
             return '';
@@ -1030,6 +1050,7 @@ export class Frontend extends EventEmitter {
                 uniqueId: device.uniqueId,
                 reachable: this.getReachability(device),
                 powerSource: this.getPowerSource(device),
+                batteryLevel: this.getBatteryLevel(device),
                 matter: device.mode === 'server' && device.serverNode ? this.matterbridge.getServerNodeData(device.serverNode) : undefined,
                 cluster: this.getClusterTextFromDevice(device),
             });
@@ -1228,8 +1249,7 @@ export class Frontend extends EventEmitter {
                         this.wssSendSnackbarMessage(`Loaded plugin ${localData.params.pluginNameOrPath}`, 5, 'success');
                         return;
                     })
-                        .catch((_error) => {
-                    });
+                        .catch((_error) => { });
                 }
                 else {
                     sendResponse({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: `Plugin ${data.params.pluginNameOrPath} not added` });
@@ -1277,8 +1297,7 @@ export class Frontend extends EventEmitter {
                         this.wssSendSnackbarMessage(`Started plugin ${localData.params.pluginName}`, 5, 'success');
                         return;
                     })
-                        .catch((_error) => {
-                    });
+                        .catch((_error) => { });
                 }
                 sendResponse({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, success: true });
             }

package/dist/matterbridge.js

@@ -67,7 +67,7 @@ export class Matterbridge extends EventEmitter {
     log = new AnsiLogger({ logName: 'Matterbridge', logTimestampFormat: 4, logLevel: hasParameter('debug') ? "debug" : "info" });
     logLevel = this.log.logLevel;
     fileLogger = false;
-    matterLog = new AnsiLogger({ logName: 'Matter', logTimestampFormat: 4, logLevel: hasParameter('debug') ? "debug" : "info" });
+    matterLog = new AnsiLogger({ logName: 'Matter', logTimestampFormat: 4, logLevel: "debug" });
     matterLogLevel = this.matterLog.logLevel;
     matterFileLogger = false;
     readOnly = hasParameter('readonly') || hasParameter('shelly');
@@ -1147,6 +1147,7 @@ export class Matterbridge extends EventEmitter {
         await addVirtualDevices(this, this.aggregatorNode);
         await this.startPlugins();
         this.log.debug('Starting start matter interval in bridge mode...');
+        this.frontend.wssSendSnackbarMessage(`The bridge is starting...`, 0, 'info');
         let failCount = 0;
         this.startMatterInterval = setInterval(async () => {
             if (failCount && failCount % 10 === 0) {
@@ -1214,6 +1215,7 @@ export class Matterbridge extends EventEmitter {
             this.log.notice('Matterbridge bridge started successfully');
             this.frontend.wssSendRefreshRequired('settings');
             this.frontend.wssSendRefreshRequired('plugins');
+            this.frontend.wssSendCloseSnackbarMessage(`The bridge is starting...`);
         }, Number(process.env['MATTERBRIDGE_START_MATTER_INTERVAL_MS']) || this.startMatterIntervalMs);
     }
     async startChildbridge(delay = 1000) {
@@ -1229,6 +1231,7 @@ export class Matterbridge extends EventEmitter {
             this.plugins.start(plugin, 'Matterbridge is starting');
         }
         this.log.debug('Starting start matter interval in childbridge mode...');
+        this.frontend.wssSendSnackbarMessage(`The bridge is starting...`, 0, 'info');
         let failCount = 0;
         this.startMatterInterval = setInterval(async () => {
             if (failCount && failCount % 10 === 0) {
@@ -1322,6 +1325,7 @@ export class Matterbridge extends EventEmitter {
             this.log.notice('Matterbridge childbridge started successfully');
             this.frontend.wssSendRefreshRequired('settings');
             this.frontend.wssSendRefreshRequired('plugins');
+            this.frontend.wssSendCloseSnackbarMessage(`The bridge is starting...`);
         }, Number(process.env['MATTERBRIDGE_START_MATTER_INTERVAL_MS']) || this.startMatterIntervalMs);
     }
     async startController() {