Release 3.5.0

[3.5.0] - 2026-01-20

Breaking Changes

• [matter]: This release brings the upgrade to matter 1.4.2 and matter.js 0.16.x. It may cause the controllers to see a new device.
• [childbridge]: Fixed nodeLabel from deviceName in childbridge mode. It may cause the controllers to see a new device.
• [modeserver]: Fixed nodeLabel from deviceName for server node devices. It may cause the controllers to see a new device.
• [matterbridge]: On restart (typically on the Home Assistant addon), when the plugin is not found and is reinstalled, it is now reinstalled from the latest dev if it was on the dev branch.
• [docker]: Removed the arch linux/arm/v7 from all docker images.

Changed device types in Matter 1.4.2

• [all]: Added ScenesManagement Cluster that is no more provisional.
• [onOffMountedSwitch]: Updated onOffOutlet and onOffMountedSwitch: when using the mounted device types add as well the outlet device types on the same endpoint as subset device type.
• [dimmableMountedSwitch]: Updated dimmableOutlet and dimmableMountedSwitch: when using the mounted device types add as well the outlet device types on the same endpoint as subset device type.
• [coverDevice]: Updated coverDevice rev. 4 and removed Scene Management cluster.
• [roboticVacuumCleaner]: Updated roboticVacuumCleaner rev. 4: OperationCompletion event for RVC Operational State cluster is now mandatory (TODO: check behavior).
• [laundryWasher]: Updated laundryWasher rev. 2: OperationCompletion event for Operational State cluster is now mandatory (TODO: check behavior).
• [laundryDryer]: Updated laundryDryer rev. 2: OperationCompletion event for Operational State cluster is now mandatory (TODO: check behavior).
• [dishwasher]: Updated dishwasher rev. 2: OperationCompletion event for Operational State cluster is now mandatory (TODO: check behavior).
• [refrigerator]: Updated refrigerator: Temperature Controlled Cabinet with Cooler condition.
• [microwaveOven]: Updated microwaveOven rev. 2: OperationCompletion event for Operational State cluster is now mandatory (TODO: check behavior).
• [cookSurface]: Updated cookSurface rev. 2: TemperatureLevel is the only valid temperature control mode.
• [temperatureControlledCabinetCooler]: Updated temperatureControlledCabinetCooler rev. 5: TemperatureNumber is the only valid temperature control mode.
• [temperatureControlledCabinetHeater]: Updated temperatureControlledCabinetHeater rev. 5: TemperatureNumber is the only valid temperature control mode and OperationCompletion event for Oven Cavity Operational State cluster is now mandatory (TODO: check behavior).

Changed clusters in Matter 1.4.2

• [BridgedDeviceBasicInformation]: Revision 5 - ConfigurationVersion attribute added as P O.
• [DoorLock]: Revision 9 - Removed AlarmMask attribute.
• [ElectricalPowerMeasurement]: Revision 2 - Changed reactive and apparent power fields to use new data types. Revision 3 - Changed range of apparent current field to allow negative apparent current.
• [FanControl]: Revision 5 - Clarified attribute usage, added conformance column.
• [Thermostat]: Revision 9 - Removed AlarmMask attribute and AlarmCodeBitmap Type.
• [Identify]: Revision 6 - Added Q quality for IdentifyTime attribute.
• [WindowCovering]: Revision 6 - Marked AbsolutePosition feature and associated elements provisional.
• [RvcCleanMode]: Revision 4 - Added VacuumThenMop cleaning mode.
• [RvcOperationalState]: Revision 4 - Added several operational states and errors.
• [ServiceArea]: Revision 2 - Renamed InitialTimeEstimate to EstimatedTime.

Added

• [jest]: Added cache inside the repo in .cache/jest.
• [frontend]: Enhanced logging for HTTP/HTTPS server binding in Frontend class.
• [matterbridge]: Excluded specific network interfaces when looking for the first external interface.
• [thermostat]: Conformance to new matter.js internal attributes externalMeasuredIndoorTemperature and externallyMeasuredOccupancy (not in Matter 1.4.2 specs).
• [scenes]: Added SceneManagement cluster when required.
• [server]: Added start and stop devices server mode in plugin restart.
• [server]: Added start and stop devices server mode in plugin enable and disable.
• [matter.js]: Bump to matter.j v. 0.16.0.
• [matter.js]: Bump to matter.j v. 0.16.1.
• [matter.js]: Bump to matter.j v. 0.16.2.
• [matter.js]: Bump to matter.j v. 0.16.3.
• [matter.js]: Bump to matter.j v. 0.16.4.
• [matter.js]: Bump to matter.j v. 0.16.5.
• [frontend]: Added the --bind parameter to bind the frontend to a specific address. Defaults to all addresses.

Changed

• [package]: Updated dependencies.
• [eslint]: Moved cache in .cache/.eslintcache.
• [prettier]: Moved cache in .cache/.prettiercache.
• [DevContainer]: Refactor DevContainer to use bridge mode and matterbridge docker network.
• [frontend]: Bumped frontend version to v. 3.4.2.

Fixed

• [evse]: Fixed the EnergyEvse.chargingEnabledUntil attribute that was wrongly set in the disable command (spec 9.3.8.4).
• [package]: Fixed the devDependencies that slipped in for a bug in 3.4.7.

Release 3.4.7

[3.4.7] - 2026-01-12

Added

• [docker]: Released for test and development the alpine and ubuntu images on Docker Hub. They are for amd64 arm64 and based on node 24. No plugins inside.
• [docker]: Updated README-DOCKER.md to include alpine and ubuntu images specifications.
• [package]: Added scripts for workspaces.
• [reflector]: Full guide.
• [@matterbridge]: Created scope @matterbridge.
• [package]: Added @matterbridge/jest-utils, @matterbridge/vitest-utils, @matterbridge/utils and @matterbridge/dgram monorepo scoped packages.
• [bug_report]: Updated the bug report issue template.
• [dockerfile]: Refactored dockerfiles and entrypoints for main, dev, ubuntu and alpine.
• [docker]: Removed from docker hub all images untagged or tag 1.x.x and 2.x.x (350 GB).
• [eslint]: Added --cache.
• [prettier]: Added --cache.

Changed

• [package]: Updated dependencies.
• [dgram]: Bumbed version number to 1.0.3 and excluded virtual, overlay, or tunnel interfaces in Dgram class.
• [network]: Bumbed version number to 1.0.3.

Fixed

• [macOS]: Fixed the macOS launchctl configuration file. Update it from the README-MACOS-PLIST.

Release 3.4.6

[3.4.6] - 2026-01-02

Added

• [MdnsReflectorClient]: Added already seen cache.
• [MdnsReflectorServer]: Added --share-with-clients to share mDNS between all reflector clients.
• [reflector]: Full guide.
• [package]: Moved to monorepo and workspaces.
• [package]: Refactored scripts for jest with cross-env.
• [jest]: Typed jest config.
• [vitest]: Refactored configuration.
• [eslint]: Refactored configuration.
• [docker]: Prepare to release also alpine and ubuntu images on Docker Hub. Both only for amd64 arm64 and based on node 24.

Changed

• [package]: Updated dependencies.
• [reflector]: Bumped reflector version to v.1.1.0.

Release 3.4.5

[3.4.5] - 2025-12-27

Added

• [DevContainer]: Refactored Dev Container setup. The Matterbridge instance can now be paired on native Linux hosts or WSL 2 with Docker engine CLI integration. On Docker Desktop on Windows or macOS is not possible cause Docker Desktop runs inside a VM and not directly on the host so mDNS is not supported.
• [DevContainer]: Since is now possible to pair from Dev Container, named volumes have been added to persist storage and plugins across rebuilds.
• [mb_mdns]: Added query and advertise interval. Improved help for easy mDNS testing.
• [mb_mdns]: Advertise full DNS-SD record set (PTR/SRV/TXT/A/AAAA) for matterbridge._http._tcp.local on port 8283.
• [Mdns]: Added TXT/SRV/A/AAAA encoders into the Mdns class.
• [Mdns]: Mdns.sendResponse now accepts an array and sends multi-answer responses.
• [MdnsReflectorClient]: Added MdnsReflectorClient class.
• [MdnsReflectorServer]: Added MdnsReflectorServer class.

Changed

• [package]: Updated dependencies.

Fixed

Release 3.4.4

[3.4.4] - 2025-12-19

Added

• [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 /regex/ in the search field to activate the regex search mode (i.e. /Frontend/). See Regex.
• [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 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.

Changed

• [package]: Updated dependencies.
• [frontend]: Bumped frontend version to v.3.4.1.

Fixed

• [doorLock]: Fixed DoorLock.supportedOperatingModes. Thanks Ludovic BOUÉ (#454).
• [frontend]: Fixed mobileMode menu navigation. Thanks Calimerorulez (#457).
• [matterbridge]: Fixed debug level of matter logger.

Release 3.4.3

[3.4.3] - 2025-12-12

Breaking Changes

• [frontend]: This version of the frontend features full responsiveness till a width of 360 pixel (smallest smartphones).
  Mobile mode starts automatically below 1200 x 900 pixels.
  From the View menu of the frontend is possible to request the desktop site or the mobile site for the mobile mode.

Added

• [frontend]: Added homepage icon and link to https://matterbridge.io/.
• [frontend]: Added settings to request Desktop site or Mobile site in mobile mode.
• [matterbridge]: Added more frontend messages on start when a plugin is in error state. It is more clear when the bridge will not start for plugin errors.

Changed

• [package]: Updated dependencies.
• [frontend]: Bumped frontend version to v.3.4.0.
• [package]: Changed homepage to https://matterbridge.io.
• [frontend]: Changed help link to https://matterbridge.io/README.html.
• [frontend]: Changed changelog link to https://matterbridge.io/CHANGELOG.html.
• [frontend]: Changed changelog icon to HistoryOutlinedIcon.
• [frontend]: Removed column Url from Devices panel in the Home page. It is already available on the Devices page.
• [frontend]: Mobile mode starts below 1200 x 900 and is fully resizable and responsive till a width of 360 pixel.

Fixed

• [matterbridge]: Plugin version is now updated even if the plugin is disabled.
• [matterbridge]: Fixed default delay and fixed_delay to 120 seconds.
• [frontend]: Fixed resize in desktop mode.

Release 3.4.2

[3.4.2] - 2025-12-05

Race condition

We have a race condition when, after a blackout or with docker compose or with other systems that start more then one process, Matterbridge starts before other required system or network components.

Race condition can cause missing configuration or missed devices on the controller side. All Matterbridge official plugins already wait for system and network components to be ready so there is no need of delay.

To solve the race condition on blackout, use the --delay parameter. There is no delay on normal restart cause the delay is applied only in the first 5 minutes from system reboot.

To solve the race condition on docker compose, use the --fixed_delay parameter. The start will always be delayed.

Added

• [frontend]: Added throttle and timeout to autoScroll in the logs.
• [frontend]: Log filters are now applied to existing messages too.
• [frontend]: Added close on success to Install dialog.
• [BroadcastServer]: Added check for port closed.
• [platform]: Added isShuttingDown property to MatterbridgePlatform.
• [delay]: Added --delay [seconds]. It will wait to start Matterbridge for the specified delay (default 2 minutes) if the system uptime is less then 5 minutes. It is a safe switch to avoid race conditions on start after a blackout.
• [fixed_delay]: Added --fixed_delay [seconds]. It will wait to start Matterbridge for the specified delay (default 2 minutes). It is a safe switch to always avoid race conditions on start on docker compose. Use only if really needed cause it will always wait.

Changed

• [package]: Updated dependencies.
• [frontend]: Bumped frontend version to v.3.3.3.
• [thread]: Bump BroadcastServer to v.2.0.1.

Fixed

• [frontend]: Fixed persistance of autoScroll.
• [frontend]: Fixed parameters info of Log panel in the Home page.

Release 3.4.1

[3.4.1] - 2025-12-01

Added

• [matterbridge.io]: Updated website https://matterbridge.io with all guides.
• [matterbridge]: Added addVirtualEndpoint() to match Matterbridge thread module.
• [BroadcastServer]: Backport BroadcastServer v.2.0.0 from Matterbridge thread module.
• [MatterbridgePrefix]: Added worker thread to get the global node_modules.
• [PluginManager]: Improved the resolve method to resolve automatically also in the plugin directory. Usefull for developing with DevContainer.

Changed

• [package]: Updated dependencies.
• [frontend]: Updated dependencies.
• [frontend]: Bumped frontend version to v.3.3.2.
• [platform]: Bumped MatterbridgePlatform v.1.6.0.
• [thread]: Bump BroadcastServer to v.2.0.0.
• [updates]: The update availability check now starts after 5 minutes and each 12 hours. It can also be triggered from the frontend.

Fixed

• [frontend]: Fixed when the user put special characters in password. Thanks Dabern (#443).
• [frontend]: Fixed minimum size to 1300x1024 and add a max width to Url. Thanks Ricardo B. (Luligu/matterbridge-home-assistant-addon#23).

Release 3.4.0

[3.4.0] - 2025-11-26

Development Breaking Changes

Removed the following long deprecated elements:

• [platform]: Matterbridge instead of PlatformMatterbridge in the platform constructor (deprecated since 3.3.0).
• [endpoint]: uniqueStorageKey instead of id in MatterbridgeEndpointOptions (deprecated since months).
• [endpoint]: endpointId instead of number in MatterbridgeEndpointOptions (deprecated since months).

Added

• [endpoint]: Added getChildEndpointById() and getChildEndpointByOriginalId().
• [endpoint]: Deprecated getChildEndpointByName(). Use getChildEndpointById() or getChildEndpointByOriginalId().
• [platform]: Added wssSendSnackbarMessage method to MatterbridgePlatform for sending snackbar notifications to the frontend.
• [doorLock]: Added autoRelockTime attribute with default 0.
• [DevContainer]: Added instructions for testing a plugin with a paired controller when using DevContainer.
• [platform]: Made internal use methods and properties hard-private.
• [platform]: Added size(), getDeviceByName(), getDeviceByUniqueId(), getDeviceBySerialNumber(), getDeviceById(), getDeviceByOriginalId(), getDeviceByNumber() and hasDeviceUniqueId() methods to retrieve a registered device.
• [platform]: Added isReady, isLoaded, isStarted and isConfigured properties.
• [matterbridge.io]: Updated website https://matterbridge.io.

Changed

• [package]: Updated dependencies.
• [platform]: Bumped MatterbridgePlatform v.1.4.0.
• [deviceManager]: Bumped DeviceManager v.1.1.1.
• [pluginManager]: Bumped PluginManager v.1.3.1.
• [broadcastServer]: Bumped BroadcastServer v.1.0.3.
• [jest]: Bumped jestHelpers v.1.0.13.
• [spawn]: Bumped spawn module v.1.2.0.

Release 3.3.8

[3.3.8] - 2025-11-15

Development Breaking Changes

This will be the last release with the following long deprecated elements:

• [platform]: Matterbridge instead of PlatformMatterbridge in the platform constructor (deprecated since 3.0.0).
• [endpoint]: uniqueStorageKey instead of id in MatterbridgeEndpointOptions (deprecated since months).
• [endpoint]: endpointId instead of number in MatterbridgeEndpointOptions (deprecated since months).

So please update your plugin.

Added

• [endpoint]: Added matterbridgeEndpointTypes.
• [devices]: Added tests for device types and their revision changes.
• [clusters]: Added test for clusters and their revision changes.
• [chip]: Added fetch script to download zcl data from connectedhomeip.
• [endpoint]: Added createDefaultPowerSourceBatteryClusterServer(). Add Power Source cluster for a generic battery device.
• [platform]: Added setSchema() to temporarly set the schema for the config editor.
• [platform]: Added getSchema() to retrieve the schema from the Matterbridge plugin manager.
• [platform]: Added return value to registerVirtualDevice().

Changed

• [package]: Updated dependencies.
• [package]: Bumped jestHelpers v.1.0.12.
• [endpoint]: Changed long deprecated uniqueStorageKey with id in MatterbridgeEndpointOptions.
• [endpoint]: Changed long deprecated endpointId with number in MatterbridgeEndpointOptions.
• [endpoint]: Added property originalId in MatterbridgeEndpoint to store the original id passed in MatterbridgeEndpointOptions (since it can be changed for matter.js storage compatibility).
• [endpoint]: Changed logger level of single device classes.