Release 3.0.6

[3.0.6] - 2025-06-13

Added

• [tests] Update Jest test coverage on addBridgedEndpoint and removeBridgedEndpoint.
• [fan]: Added createMultiSpeedFanControlClusterServer cluster helper with MultiSpeed feature.
• [fan]: Added all parameters to the fan cluster helpers.
• [valve]: Added logic in MatterbridgeValveConfigurationAndControlServer.
• [command]: Added cluster property to commandHandler data object.
• [mb-service]: Added a link to mb-service package by Michael Ahern. It runs matterbridge as a service in macOS.

Changed

• [package]: Updated dependencies.
• [fan]: The default fan has no more the MultiSpeed feature.
• [behaviors]: Bump Matterbridge Behaviors to 1.3.0
• [evse]: Updated class and behavior to 1.1.0.
• [waterHeater]: Updated class and behavior to 1.1.0.
• [rvc]: Updated class and behavior to 1.1.0.
• [laundryWasher]: Updated class and behavior to 1.1.0.

Fixed

• [evse]: Fixed jsdoc on Evse.

Release 3.0.5

[3.0.5] - 2025-06-07

Added

• [cli]: Added takeHeapSnapshot() and triggerGarbageCollection() for internal testing.
• [LaundryWasher]: Added Evse class and Jest test. Thanks Ludovic BOUÉ.
• [LaundryWasher]: Added LaundryWasher class and Jest test.
• [WaterHeater]: Added WaterHeater class and Jest test. Thanks Ludovic BOUÉ.
• [nginx]: Added new example configurations for nginx.

Changed

• [package]: Updated dependencies.
• [matter.js]: Update to 0.14.0-alpha.0-20250528-d6d12ae65.
• [matter.js]: Update to 0.14.0. Great job matter.js!

Fixed

• [selectAreas]: Fixed MatterbridgeServiceAreaServer.selectAreas.

Release 3.0.4

[3.0.4] - 2025-05-26

Added

• [jsdoc]: Improved jsdoc for cluster helpers.
• [cover]: Added createDefaultLiftTiltWindowCoveringClusterServer() that create a window covering cluser with both lift and tilt features (supported by Apple Home).

Changed

• [legacy]: Removed legacy matter.js EndpointServer and logEndpoint that will be removed in matter.js 0.14.0. For developers: if you need to log the endpoint the call is Logger.get('LogEndpoint').info(endpoint).
• [package]: Updated dependencies.
• [package]: Updated multer package to 2.0.0.

Fixed

• [virtualDevice]: Fixed possible vulnerability in the length of the nodeLabel.

Release 3.0.3

[3.0.3] - 2025-05-19

New plugins

Dyson robot

A Matterbridge plugin that connects Dyson robot vacuums and air treatment devices.
to the Matter smart home ecosystem via their local MQTT APIs.

Aeg robot

AEG RX 9 / Electrolux Pure i9 robot vacuum plugin for Matterbridge.

Added

• [virtual] Added virtual devices configuration mode in the Matterbridge Settings: 'Disabled', 'Light', 'Outlet', 'Switch', 'Mounted_switch'. Switch is not supported by Alexa. Mounted Switch is not supported by Apple.
• [deviceTypes] Added evse, waterHeater, solarPower, batteryStorage and heatPump device type.
• [waterHeater] Added WaterHeater class to create a Water Heater Device Type in one line of code (thanks https://github.com/lboue).
• [subscribe] Added a third parameter context (provisional implementation: when "context.offline === true" then this is a change coming from the device).

Changed

• [package]: Updated dependencies.
• [export]: Removed long deprecated Matter exports from matterbridge. Use matterbridge/matter.
• [matterbridge]: Refactored initialize() and cleanup() methods.
• [matterbridge]: Updated -help informations.
• [rvc]: Added the parameters in the RoboticVacuumCleaner class constructor.

Release 3.0.2

[3.0.2] - 2025-05-??

Added

• [virtual] Added virtual devices Restart Matterbridge and Update Matterbridge and full Jest tests.
• [virtual] Added virtual devices Reboot Matterbridge for Shelly board and full Jest tests.
• [shelly] Refactor shelly api and added full Jest test.

Changed

• [package]: Updated dependencies.
• [utils]: Refactor utils functions.
• [utils]: Updated Jest tests on utils functions.
• [devices]: Added RoboticVacuumCleaner class to create the Robotic Vacuum Cleaner device type in one line of code.

Fixed

• [frontend]: Fixed refresh of start/stop sharing.

Release 3.0.1

[3.0.1] - 2025-05-06

Added

• [docker]: The builder for the docker image with tag latest will run each day at 00:00 UTC if there are new releases. Inside the image matterbridge and all plugins with the latest release (as published on npm) are already loaded. You can just pull the new image and matterbridge with all plugins will be updated to the latest.
• [docker]: The builder for the docker image with tag dev will run each day at 00:00 UTC if there are new commits. Inside the image matterbridge and all plugins with the dev release (as pushed on GitHub) are already loaded. You can just pull the new image and matterbridge with all plugins will be updated to the latest dev. It is possible that the devs are outdated by some published latests.
• [npm]: The dev of matterbridge is published with tag dev on npm each day at 00:00 UTC if there is a new commit. It is possible that the dev is outdated by a published latest.
• [frontend]: Added closeSnackbarMessage() to remove the notification with timeout = 0.
• [frontend]: Moved all plugin actions from express to web socket.
• [frontend]: Moved all settings from express to web socket.
• [endpoint]: Added OperationalState cluster helper and behavior.
• [behaviors]: Added Jest test on MatterbridgeBehaviors.

Changed

• [package]: Updated dependencies.
• [docker]: Updated the Docker configurations.
• [frontend]: Changing configuration for a plugin now only lock configuration on that plugin.
• [frontend]: Optimized rendering of Devices and Plugins panels.
• [frontend]: Frontend v.2.6.4.

Fixed

• [BasicInformation]: Fixed vulnerability in BasicInformation and BridgedDeviceBasicInformation cluster initialization attributes.
• [frontend]: Fixed refresh and postfix for select in HomeDevices.

Release 3.0.0

Breaking changes

This release brings Matter 1.4.

New device types:

• onOffMountedSwitch: Mounted On/Off Control (an onOff switch without client cluster!).
• dimmableMountedSwitch: Mounted Dimmable Load Control (a dimmer switch without client cluster!).

Modified clusters:

• OccupancySensing cluster.

[3.0.0] - 2025-04-29

Added

• [addEndpoint]: Added an error handler with deep stack on aggregatorNode.add() and serverNode.add() calls.
• [endpoint]: Added createOffOnlyOnOffClusterServer().
• [endpoint]: Added createBaseFanControlClusterServer().
• [endpoint]: Added createDefaultHepaFilterMonitoringClusterServer().
• [endpoint]: Added createDefaultActivatedCarbonFilterMonitoringClusterServer().
• [endpoint]: Added createDefaultThermostatUserInterfaceConfigurationClusterServer().
• [deviceTypes]: Added Robotic device type (please read #264).
• [deviceTypes]: Added Appliances device types (please read #264).
• [frontend]: Added the matterbridge aggregator serialNumber in the QRDiv.
• [frontend]: Added Power column in the Devices panel of the Home page.
• [frontend]: Added support for appliances and robot in IconView.
• [parameter]: Added getIntArrayParameter and getStringArrayParameter.
• [frontend]: Added the view menu to load the logs directly in the browser.

Changed

• [package]: Updated package.
• [package]: Updated express to v5.1.0.
• [package]: Updated dependencies.
• [frontend]: Frontend v.2.6.3.
• [frontend]: Changed icons with mdiIcons in IconView.
• [package]: Added tsconfig.jest.json with "isolatedModules": true for ts-jest.
• [deviceTypes]: Updated device types to Matter 1.4.
• [clusters]: Updated cluster helpers to Matter 1.4.
• [matter.js]: Update to 0.13.0-alpha.0-20250405-7fc7db48.
• [matter.js]: Update to 0.13.0-alpha.0-20250408-c916c7e8.
• [matter.js]: Update to 0.13.0-alpha.0-20250412-5fad64e7b.
• [matter.js]: Update to 0.13.0-alpha.0-20250413-d5a27700d.
• [matter.js]: Update to 0.13.0-alpha.0-20250415-475996bb5.
• [matter.js]: Update to 0.13.0-alpha.0-20250418-8cfc0b832.
• [matter.js]: Update to 0.13.0-alpha.0-20250420-9f45e4f77.
• [matter.js]: Update to 0.13.0-alpha.0-20250422-0d27f26be.
• [matter.js]: Update to 0.13.0-alpha.0-20250423-8917d1d1d.
• [matter.js]: Update to 0.13.0-alpha.0-20250424-4760af1f3.
• [matter.js]: Update to 0.13.0-alpha.0-20250425-94b33ff98.
• [matter.js]: Update to 0.13.0-alpha.0-20250427-e7df8aa45.
• [matter.js]: Update to 0.13.0.
• [help]: Updated cli help screen.
• [logger]: Improved frontend logger cleaning.

Fixed

• [doorLock]: Fixed supportedOperatingModes inverted bitmap (Thanks Apollon).
• [DevicesIcon]: Fixed rendering of leak freeze and rain sensors.
• [QRCode]: Fixed rendering of QRCode panel when advertising stops.
• [matterbridge]: Fixed wrong message when advertising stops and the node has been paired.
• [frontend]: Fixed download logs that broke with express v5.1.0.

Release 2.2.9

[2.2.9] - 2025-04-18

Added

• [deviceTypes]: Added extendedColorLight device type.

Changed

• [package]: Update dependencies.

Fixed

• [QRCode]: Fixed update when the server node is no more advertising.
• [frontend]: Fixed wrong notification when the server node has been paired.

Release 2.2.8

[2.2.8] - 2025-04-10

Added

• [platform]: Added stack to error messages.
• [endpoint]: Added createLevelControlClusterServer()
• [endpoint]: Added createLevelTvocMeasurementClusterServer()
• [frontend]: Added a restart button on the QRCode panel when the advertising for a not paired node is expired.

Changed

• [package]: Update dependencies.
• [package]: Use node:https.
• [endpoint]: Modified createOnOffClusterServer().

Fixed

• [homepage]: Fixed warning log for homepage property in package.json.
• [DevicesIcon]: Fixed rendering of rain, freeze and leak sensors.

Release 2.2.7

[2.2.7] - 2025-04-06

Added

• [package]: Process author, homepage, repository, funding, README.md and CHANGELOG.md for third-party plugins. If the default implementation doesn't fit, it is possible to add a custom property "help" and "changelog" to the package.json.
• [frontend]: Added a link to the plugin homepage (click on the plugin name or on the plugin description).

Changed

• [frontend]: Frontend v.2.6.1.
• [package]: Update dependencies.

Fixed

• [author]: Fixed case when author is an object in the package.json.
• [platform]: Fix getSelectDevices and getSelectEntities on node < 22.