matterbridge 3.5.2-dev-20260126-3915bc2 → 3.5.2-dev-20260129-e83daf7

package/CHANGELOG.md

@@ -1,4 +1,4 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge changelog
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge changelog
 
 All notable changes to this project will be documented in this file.
 
@@ -17,7 +17,7 @@ The project will evolve to a multi-threaded architecture (the CLI will become th
 - all plugins in bridge mode;
 - each plugin in childbridge mode;
 
-- check updates;
+- ✅ check updates;
 - npm install;
 - ✅ get the global node_modules directory;
 
@@ -34,14 +34,22 @@ Advantages:
 
 - [matterbridge]: Added brand to MatterbridgeAccessoryPlatform and MatterbridgeDynamicPlatform.
 - [PluginManager]: Verify brand of MatterbridgePlatform, MatterbridgeAccessoryPlatform and MatterbridgeDynamicPlatform.
+- [PluginManager]: Added frontend message when a plugin is not added cause it is in the pluginIgnoreList or for other issues.
 - [MatterbridgePlatform]: Verify brand of MatterbridgeEndpoint.
-- [BasicVideoPlayer]: Added Basic Video Player class (suported by SmartThings).
+- [BasicVideoPlayer]: Added **Basic Video Player** class (suported by SmartThings).
+- [frontend]: Added **pluginIgnoreList** to avoid to install a plugin that is only a test or a name reservation on npm.
+- [docker]: Added instructions about how to disable the health check when you override the frontend port.
+- [Alexa]: Added a full review of supported device types and known issues. Thanks [Tamer Salah](https://github.com/tammeryousef1006).
+- [virtual]: Added outlet to mounted switch device type in virtual devices (Matter .1.4.2).
+- [package]: Added @matterbridge/thread monorepo scoped package.
 
 ### Changed
 
 - [package]: Updated dependencies.
-- [docker]: Clarified in docker readme the content of the matterbridge docker images on Docker Hub.
-- [frontend]: The frontend now shows when the plugin version is from the matterbridge docker image with tag dev.
+- [docker]: Clarified in [README-DOCKER.md](README-DOCKER.md) the content of the matterbridge docker images on Docker Hub.
+- [frontend]: Bumped `frontend` version to v. 3.4.3.
+- [frontend]: For the matterbridge docker image with tag dev, the frontend now shows the versions with the tag git.
+- [worker]: Bumped worker module to v. 1.1.0.
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
 
@@ -58,7 +66,7 @@ Advantages:
 - [mb_mdns]: Added --ip-filter params to filter incoming mDns messages by sender ip.
 - [express]: Added a login check for internal express api. The /health and /memory api don't need a login. Thanks Rogibaer (https://github.com/Luligu/matterbridge-hass/issues/149).
 - [readme]: Added a section with the data structure and backup/restore guidelines.
-- [matterbridge]: Add brand to MatterbridgePlatform and MatterbridgeEndpoint.
+- [matterbridge]: Added brand to MatterbridgePlatform and MatterbridgeEndpoint.
 
 ### Changed
 

package/README-DEV.md

@@ -1,9 +1,9 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge development
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge development
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)

package/README-DOCKER.md

@@ -1,45 +1,41 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge docker configuration
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge Docker configuration
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
 
-[![power by](https://img.shields.io/badge/powered%20by-matter--history-blue)](https://www.npmjs.com/package/matter-history)
-[![power by](https://img.shields.io/badge/powered%20by-node--ansi--logger-blue)](https://www.npmjs.com/package/node-ansi-logger)
-[![power by](https://img.shields.io/badge/powered%20by-node--persist--manager-blue)](https://www.npmjs.com/package/node-persist-manager)
+[![powered by](https://img.shields.io/badge/powered%20by-matter--history-blue)](https://www.npmjs.com/package/matter-history)
+[![powered by](https://img.shields.io/badge/powered%20by-node--ansi--logger-blue)](https://www.npmjs.com/package/node-ansi-logger)
+[![powered by](https://img.shields.io/badge/powered%20by-node--persist--manager-blue)](https://www.npmjs.com/package/node-persist-manager)
 
 ---
 
-# Advanced configuration
+# Production configuration
 
-## Run matterbridge with docker and docker compose
+## Run Matterbridge with Docker and Docker Compose
 
-The Matterbridge Docker images, which include a manifest list for the linux/amd64 and linux/arm64 architectures, are published on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge). If you use the matterbridge docker images, please consider giving them a star on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge).
+The Matterbridge Docker images (multi-arch manifest list for **linux/amd64** and **linux/arm64**) are published on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge). If you use them, please consider starring the project on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge).
 
-The image (tag **latest**) includes matterbridge and all official plugins with the latest release as published on npm. The image is based on node:22-bookworm-slim. Since all official plugins are included, you can directly select and add a plugin without installing it.
+The image (tag **latest**) includes Matterbridge and all official plugins, using the latest release published on npm. It is based on `node:22-bookworm-slim`. Since all official plugins are included, you can select and add a plugin without installing anything.
 
-The image (tag **dev**) includes matterbridge and all official plugins with the latest push on GitHub. The image is based on node:22-bookworm-slim. Since all official plugins are included, you can directly select and add a plugin without installing it. If you update to the latest dev from the frontend, you override the latest push on GitHub with the latest dev published on npm.
+The image (tag **dev**) includes Matterbridge and all official plugins from the latest push on GitHub. It is based on `node:22-bookworm-slim`. Since all official plugins are included, you can select and add a plugin without installing anything. Note: if you update to the latest **dev** from the frontend, you will override the GitHub version with the latest **dev** published on npm.
 
-For development and testing see also the **ubuntu** and **alpine** [Development Images](README-DOCKER.md#development-images).
+The image (tag **ubuntu**) includes only Matterbridge, using the latest release published on npm. This image (**for test and development only**) is based on `ubuntu:latest` with Node.js 24 from NodeSource. Plugins are not included in the image; they will be installed on first run. This image preinstalls `bluetooth`, `build-essential`, and `python` packages (useful for plugins that require native builds).
 
-### Docker health check
-
-All images integrate the health check.
+The image (tag **alpine**) includes only Matterbridge, using the latest release published on npm. This image (**for test and development only**) is based on `node:24-alpine`. Plugins are not included in the image; they will be installed on first run.
 
-How Health Checks Work in Different Scenarios
-
-With docker-compose:
+### Docker health check
 
-Docker monitors the health check and can restart the container if needed.
+All images include a health check.
 
-With docker run:
+How health checks work in different scenarios:
 
-The health check still runs in the background, but:
-The container doesn’t restart automatically if it becomes unhealthy.
+- With Docker Compose: Docker monitors the health check and can restart the container (depending on your restart policy).
+- With `docker run`: the health check still runs, but the container will not restart automatically when it becomes unhealthy.
 
 You can manually check the health status:
 
@@ -47,9 +43,9 @@ You can manually check the health status:
 docker exec -it matterbridge curl -v http://localhost:8283/health
 ```
 
-### First create the Matterbridge directories
+### Create the Matterbridge directories first
 
-This will create the required directories in your home directory if they don't exist
+This creates the required directories in your home directory (if they don't already exist):
 
 ```bash
 cd ~
@@ -59,9 +55,9 @@ mkdir -p ~/.mattercert
 sudo chown -R $USER:$USER ~/Matterbridge ~/.matterbridge ~/.mattercert
 ```
 
-You may need to adapt the script to your setup.
+You may need to adapt the paths to your setup.
 
-### Add your user to docker group
+### Add your user to the docker group
 
 If you don't want to use sudo with docker commands, run this command:
 
@@ -70,11 +66,11 @@ sudo groupadd docker
 sudo usermod -aG docker $USER
 ```
 
-After adding your user to the docker group, you need to log out and log back in for the changes to take effect. This ensures that your current session recognizes the group membership change.
+After adding your user to the `docker` group, log out and log back in so your current session picks up the new group membership.
 
-### Run the Docker container and start it
+### Run the container
 
-The container must have full access to the host network (needed for mdns and Matter protocol).
+The container must have full access to the host network (needed for mDNS and the Matter protocol).
 
 ```bash
 sudo docker run --name matterbridge \
@@ -84,9 +80,9 @@ sudo docker run --name matterbridge \
   --network host --restart always -d luligu/matterbridge:latest
 ```
 
-You may need to adapt the script to your setup.
+You may need to adapt the paths to your setup.
 
-### Run the Docker container and start it adding different parameters (i.e. frontend on port 8585)
+### Run the container with extra parameters (e.g. frontend on port 8585)
 
 ```bash
 sudo docker run --name matterbridge \
@@ -97,18 +93,20 @@ sudo docker run --name matterbridge \
   matterbridge --docker --frontend 8585
 ```
 
-If you override, always use `matterbridge --docker` like first part of the command.
+If you override the command, always start it with `matterbridge --docker`.
 
-### Run with docker compose
+**If you change the frontend port, overriding the default command of the images, docker will report the container unhealty unless you add the --no-healthcheck param**.
 
-The docker-compose.yml file is available in the docker directory of the package
+### Run with Docker Compose
+
+The `docker-compose.yml` file is available in the `docker` directory of this repository:
 
 ```yaml
 services:
   matterbridge:
     container_name: matterbridge
     image: luligu/matterbridge:latest                         # Matterbridge image with the tag latest
-    network_mode: host                                        # Ensures the Matter mdns works
+    network_mode: host                                        # Ensures the Matter mDNS works
     restart: always                                           # Ensures the container always restarts automatically
     volumes:
       - "${HOME}/Matterbridge:/root/Matterbridge"             # Mounts the Matterbridge plugin directory
@@ -116,21 +114,21 @@ services:
       - "${HOME}/.mattercert:/root/.mattercert"               # Mounts the Matterbridge certificate directory
 ```
 
-Copy it in the home directory or edit the existing one to add the matterbridge service.
+Copy it to your home directory or edit your existing compose file to add the Matterbridge service.
 
-Then start docker compose with:
+Then start Docker Compose with:
 
 ```bash
 docker compose up -d
 ```
 
-or start only the matterbridge container with:
+Or start only the Matterbridge container with:
 
 ```bash
 docker compose up -d matterbridge
 ```
 
-If you need to start matterbridge adding different parameters (i.e. frontend on port 8585), you can override the default command adding the line command to the service:
+If you need to start Matterbridge with extra parameters (e.g. frontend on port 8585), override the default command by adding a `command` line to the service:
 
 ```yaml
 services:
@@ -139,17 +137,24 @@ services:
     command: ["matterbridge", "--docker", "--frontend", "8585"]
 ```
 
-If you override, always use `["matterbridge", "--docker"]` like first part of the command.
+If you override the command, always start it with `["matterbridge", "--docker"]`.
 
-### Stop with docker compose
+**If you change the frontend port, overriding the default command of the images, docker will report the container unhealty unless you add:**.
+
+```yaml
+    healthcheck:
+      disable: true
+```
+
+### Stop with Docker Compose
 
 ```bash
 docker compose down
 ```
 
-### Update with docker compose
+### Update with Docker Compose
 
-This will pull the new matterbridge image and restart only the matterbridge container.
+This pulls the new Matterbridge image and restarts only the Matterbridge container:
 
 ```bash
 docker compose pull matterbridge
@@ -180,13 +185,13 @@ docker stop matterbridge
 docker restart matterbridge
 ```
 
-### Shows the logs
+### Show the logs
 
 ```bash
 docker logs matterbridge
 ```
 
-### Shows the logs for a time interval
+### Show the logs for a time interval
 
 ```bash
 docker logs \
@@ -195,15 +200,15 @@ docker logs \
   matterbridge
 ```
 
-### Shows the logs real time (tail)
+### Show the logs in real time (tail)
 
 ```bash
 docker logs --tail 1000 -f matterbridge
 ```
 
-### Prevent the logs to grow
+### Prevent log growth
 
-If you want to prevent the docker logs to grow too much, you can configure Docker's logging options globally.
+If you want to prevent Docker logs from growing too much, you can configure Docker's logging options globally.
 
 **Warning**: This will restart Docker and affect all running containers.
 
@@ -211,7 +216,7 @@ If you want to prevent the docker logs to grow too much, you can configure Docke
 sudo nano /etc/docker/daemon.json
 ```
 
-Add or update the logging configuration in the daemon.json file:
+Add or update the logging configuration in `daemon.json`:
 
 ```json
 {
@@ -234,12 +239,4 @@ Save the file and restart Docker:
 sudo systemctl restart docker
 ```
 
-**Note**: This configuration applies to new containers. Existing containers will need to be recreated to use the new logging settings.
-
-## Development images
-
-On [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge) are also published **for test and development** the Matterbridge ubuntu and alpine images, which include a manifest list for the linux/amd64, linux/arm64 architectures and are based on node 24.x.
-
-The image (tag **ubuntu**) includes only matterbridge with the latest release (as published on npm). The plugins are not included in the image but they will be reinstalled on the first run. This image has preinstalled bluetooth essentials and python (it can be used with plugins that require bluetooth, build-essential and python).
-
-The image (tag **alpine**) includes only matterbridge with the latest release (as published on npm). The plugins are not included in the image but they will be reinstalled on the first run.
+**Note**: This configuration applies to new containers. Existing containers must be recreated to use the new logging settings.

package/README-MACOS-PLIST.md

@@ -1,9 +1,9 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge launchctl configuration (macOS)
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge launchctl configuration (macOS)
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
@@ -14,7 +14,7 @@
 
 ---
 
-# Advanced configuration
+# Production configuration
 
 ## Run matterbridge as system service with launchctl (macOS) and its own global node_modules directory
 

package/README-NGINX.md

@@ -1,9 +1,9 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge NGINX configuration
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge NGINX configuration
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)

package/README-PODMAN.md

@@ -1,9 +1,9 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge Podman configuration
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge Podman configuration
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
@@ -14,7 +14,7 @@
 
 ---
 
-# Advanced configuration
+# Production configuration
 
 ## Install Podman if it is not already installed
 

package/README-SERVICE-LOCAL.md

@@ -1,9 +1,9 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge systemd configuration with local global node_modules
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge systemd configuration with local global node_modules
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
@@ -14,7 +14,7 @@
 
 ---
 
-# Advanced configuration
+# Production advanced configuration
 
 ## Run matterbridge as a daemon with systemctl (Linux only) with local global node_modules
 

package/README-SERVICE-OPT.md

@@ -1,9 +1,9 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge systemd configuration with private global node_modules
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge systemd configuration with private global node_modules
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
@@ -14,7 +14,7 @@
 
 ---
 
-# Advanced configuration
+# Production advanced configuration
 
 ## Run matterbridge as a daemon with systemctl (Linux only) with user matterbridge and private global node_modules
 

package/README-SERVICE.md

@@ -1,9 +1,9 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge systemd configuration
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge systemd configuration
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
@@ -14,7 +14,7 @@
 
 ---
 
-# Advanced configuration
+# Production configuration
 
 ## Run matterbridge as a daemon with systemctl (Linux only)
 

package/README.md

@@ -1,9 +1,9 @@
-# <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
+# <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
-[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
-[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge/latest?label=docker%20version)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge?label=docker%20pulls)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
@@ -39,7 +39,7 @@ It runs perfectly on Linux, macOS and Windows.
 
 If you like this project and find it useful, please consider giving it a star on [GitHub](https://github.com/Luligu/matterbridge) and sponsoring it.
 
-<a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
+<a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
 
 ## Acknowledgements
 
@@ -282,7 +282,7 @@ It is the ideal companion of the official [Matterbridge Home Assistant Add-on](h
 ### Webhooks
 
 <a href="https://github.com/Luligu/matterbridge-webhooks">
-  <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge logo" width="100" />
+  <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge logo" width="100" />
 </a>
 
 Matterbridge Webhooks plugin allows you to expose any webhooks to Matter.
@@ -290,7 +290,7 @@ Matterbridge Webhooks plugin allows you to expose any webhooks to Matter.
 ### BTHome
 
 <a href="https://github.com/Luligu/matterbridge-webhooks">
-  <img src="https://matterbridge.io/matterbridge.svg" alt="Matterbridge logo" width="100" />
+  <img src="https://matterbridge.io/assets/matterbridge.svg" alt="Matterbridge logo" width="100" />
 </a>
 
 Matterbridge BTHome allows you to expose any BTHome device to Matter using the native bluetooth of the host machine.
@@ -553,11 +553,15 @@ In Matter spec the Window Covering cluster uses:
 - 10000 = fully closed
 - 0 = fully opened
 
-So depending on the controller you pair with, you should see 100 for fully closed and 0 for fully open.
+So you should see 100% for fully closed and 0% for fully open.
 
-Some controllers invert the position so you need to verify your controller.
+Some controllers interpret the position the other way around (they show “open” as “closed” and vice versa). If the percentages look reversed, it’s a controller-specific UI behavior. Alexa is a common example.
 
-## Data structure
+## How to disable Restart matterbridge and update matterbridge
+
+In the settings page of the frontend, set virtual devices to Disabled.
+
+## Data structure for backup and restore
 
 Matterbridge uses three directories. These are the default locations (some advanced setups may change them, so check your configuration):
 
@@ -641,14 +645,22 @@ Install Google Home on an iPhone and complete the commissioning there. Once set
 
 ## Alexa
 
-Tested by Tamer Salah
-
-Alexa needs the standard port 5540 to pair (from matter.js readme).
-
-There is no support for these Matter device types:
-
-- pressure sensor
-- flow sensor
+Tested by [Tamer Salah](https://github.com/tammeryousef1006).
+
+Alexa integrates with Matterbridge to locally control non-native devices by acting as a Matter Controller. While Amazon has expanded support to include core categories like lighting, plugs, thermostats, locks, and sensors, many advanced or specialized device types defined in the latest Matter specifications are not yet recognized by the Alexa ecosystem.
+Alexa Support vs. Matterbridge Test Results
+During testing, Alexa successfully managed most standard smart home categories but failed to recognize or fully support the following types exposed via Matterbridge:
+Appliances & Kitchen: Cooktop, Microwave Oven, Oven, Refrigerator, Laundry Washer/Dryer, and Extractor Hood.
+Energy & Utilities: Battery Storage, EVSE (Electric Vehicle Supply Equipment), and Solar Power.
+Water & Infrastructure: Water Valve, Water Heater, Water Leak/Freeze sensors, Pump, and Rain Sensor.
+Media & Controls: Basic Video Player and Speaker.
+Specialized Sensors/Inputs: Heat Pump, Latching Switch, Flow, and Pressure.
+Limited Support: Cover Lift and Tilt devices only functioned for lift operations, with tilt functionality unsupported.
+Integration Limitations
+Even when a device is recognized, Alexa may face specific bridge-related limitations:
+Device Caps: Alexa currently supports a maximum of 50 bridged devices per connection; exceeding this limit may cause devices to disappear from the Alexa App.
+Latency: While Matter is designed for local control, status updates in the Alexa app may occasionally lag if the app remains open during external state changes.
+Feature Gaps: Advanced features for certain types, such as unlocking specific smart locks, may be disabled by default for security and require manual activation within the app
 
 Known issues:
 
@@ -687,7 +699,7 @@ On my side I sponsor the packages that I use in this project and single develope
 Click on the badge below to get started:
 
 <a href="https://www.buymeacoffee.com/luligugithub">
-  <img src="https://matterbridge.io/bmc-button.svg" alt="Buy me a coffee" width="120">
+  <img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="120">
 </a>
 
 Thank you for your support!

package/bin/mb_health.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+const { mbHealthMain } = await import('../dist/mb_health.js');
+await mbHealthMain();

package/dist/broadcastServerTypes.d.ts

@@ -1,8 +1,8 @@
 import { LogLevel } from 'node-ansi-logger';
 import { EndpointNumber } from '@matter/types/datatype';
-import { RefreshRequiredChanged, WsMessageBroadcast } from './frontendTypes.js';
-import type { PlatformConfig, PlatformSchema } from './matterbridgePlatform.js';
-import type { ApiMatter, ApiPlugin, BaseDevice, Plugin, StoragePlugin } from './matterbridgeTypes.js';
+import type { RefreshRequiredChanged, WsMessageBroadcast } from './frontendTypes.js';
+import type { PlatformConfig, PlatformMatterbridge, PlatformSchema } from './matterbridgePlatformTypes.js';
+import type { ApiMatter, ApiPlugin, BaseDevice, Plugin, SharedMatterbridge, StoragePlugin } from './matterbridgeTypes.js';
 export type WorkerSrcType = 'manager' | 'matterbridge' | 'plugins' | 'devices' | 'frontend' | 'matter' | 'platform' | 'spawn' | 'updates';
 export type WorkerDstType = 'manager' | 'matterbridge' | 'plugins' | 'devices' | 'frontend' | 'matter' | 'platform' | 'spawn' | 'updates' | 'all';
 type NormalizeRequest<T> = T extends {
@@ -184,6 +184,28 @@ export type WorkerMessageTypes = {
             };
         };
     };
+    'matterbridge_platform': {
+        request: {
+            params: undefined;
+        };
+        response: {
+            result: {
+                data: PlatformMatterbridge;
+                success: true;
+            };
+        };
+    };
+    'matterbridge_shared': {
+        request: {
+            params: undefined;
+        };
+        response: {
+            result: {
+                data: SharedMatterbridge;
+                success: true;
+            };
+        };
+    };
     'matter_start': {
         request: {
             params: {