Release 1.2.1

[1.2.1] - 2026-05-01

Added

• [light]: Add discovery of dimmer lights when they are unavailable in Home Assistant. Thanks DrFate09.
• [cache]: Add StateCache class to store the device states when they turn to unavailable in Home Assistant. This allows to create correct lights even if they are unavailable on Home Assistant.
• [eslint]: Enforce @typescript-eslint promise rules.

Changed

• [package]: Update dependencies.
• [package]: Bump package to automator v.3.1.7.
• [package]: Bump eslint to v.10.3.0.
• [package]: Bump typescript-eslint to v.8.59.1.
• [eslint]: Remove eslint-plugin-promise (not actively maintained) and add optional @typescript-eslint promise rules.
• [package]: Remove overrides that was necessary for eslint-plugin-promise.
• [package]: Remove unused Vitest setup.
• [eslint]: Add eslint v.2.0.0 config.
• [prettier]: Add prettier v.2.0.0 config.
• [jest]: Add jest v.2.0.0 config.

Release 1.2.0

[1.2.0] - 2026-04-24

Breaking Changes

• [domains]: Domains remote, select, input_select and media_player are now supported. You may want to either use them with filter and select or exclude all these domains if you don't need their entities or your controller doesn't support them. It is also possible to split them.
• [Split Entities]: The Split Entities config option is deprecated. Use Split By Label.

Added

• [test]: Refactor tests to use the updated matterbridge test module.
• [remote]: Add remote domain.
• [select]: Add select domain.
• [input_select]: Add input_select domain.
• [media_player]: Add media_player domain.
• [Virtual Control]: Add the Virtual Control Label for accessibility controls (voice-friendly switches) on supported entities such as select, input_select and media_player.

Changed

• [package]: Preliminary compatibility update to matterbridge 3.8.0, matter 1.5.1 and matter.js 0.17.0.
• [package]: Update dependencies.
• [package]: Bump typescript to v.6.0.3.
• [package]: Bump eslint to v.10.2.1.
• [package]: Bump typescript-eslint to v.8.59.0.
• [package]: Add .vscode\settings.json.
• [devcontainer]: Add Claude Code for VS Code extension to Dev Container.

Release 1.1.1

[1.1.1] - 2026-04-17

Added

• [package]: Preliminary compatibility update to matterbridge 3.8.0, matter 1.5.1 and matter.js 0.17.0.
• [hidden]: All entities that are hidden are discarded unless discardHiddenEntities options is unchecked. Thanks kristian (#213).
• [report]: Update the report to show the hidden entities.
• [readme]: Changed config headers in the README to reflect schema titles.
• [select]: Add definitions for select and input_select domain.
• [media_player]: Add definitions for media_player domain.
• [binary_sensor]: The default implementation without device_class is a contact sensor.

Changed

• [package]: Update dependencies.
• [package]: Bump package to automator v.3.1.6.
• [package]: Bump typescript-eslint to v.8.58.2.
• [agent]: Add .github\copilot-instructions.md for copilot.
• [agent]: Add .claude\CLAUDE.md for claude.
• [agent]: Add agent custom instructions (testing) for copilot and claude.
• [agent]: Add agent custom instructions (matterbridge) for copilot and claude.

Fixed

• [reconnect]: Prevent unhandled promise rejection during reconnect attempts. Thanks UltronOfSpace (#211).

Release 1.1.0

[1.1.0] - 2026-04-10

Breaking Changes

• [domains] Add Domain Whitelist and Domain Blacklist.

Added

• [helpers]: Add helpers module to make the platform code easier to read and maintain.
• [helpers]: Add payload module to make the platform code easier to read and maintain.
• [helpers]: Add report module to make the platform code easier to read and maintain.
• [scripts]: Add script to prune GitHub releases based on tag prefix.

Changed

• [package]: Update dependencies.
• [package]: Bump package to automator v.3.1.5.
• [package]: Bump eslint to v.10.2.0.
• [package]: Bump prettier to v.3.8.2.
• [package]: Bump typescript-eslint to v.8.58.1.
• [devcontainer]: Update VS Code settings.
• [scripts]: Update mb-run script.
• [entity]: Refactor entity helper signatures to be uniform across all helpers.

Fixed

• [schema]: Fix controllerStrategy schema.
• [devcontainer]: Fix pull of new image.
• [devcontainer]: Fix matterbridge scripts.

Release 1.0.12

[1.0.12] - 2026-04-02

Breaking Changes

• [button]: The domain button (added in 1.0.11) can cause the lights to not be anymore on the root endpoint. You can filter out or unselect the button entity (or split it) in that case (for Alexa). Thanks Rogibaer (#205);

Added

• [rvc]: Add warning when enableServerRvc is true and the rvc has more entities. With Apple Home the rvc must be the unique device type: filter out, unselect or split all other entities that belong to the rvc device. Thanks hoppel118.
• [splitByLabel]: Split device entities by label (use label name). All device entities with this label will be split. See the readme for more informations.
• [split]: Split device entities have the link to the main device and composed type "Hass Split".
• [controllerStrategy]: Add controllerStrategy config option. 'Merge' will merge each not overlapping device types on the main endpoint. 'Matter' will create a separate endpoint for each device type. Use Merge strategy for legacy controller. Change this setting may require to pair again the controller. See the readme for more informations.

Changed

• [package]: Update dependencies.
• [package]: Bump package to automator v.3.1.4.
• [package]: Bump typescript to v.6.0.2.
• [package]: Bump typescript-eslint to v.8.58.0.
• [package]: Add CODE_OF_CONDUCT.md.

Release 1.0.11

[1.0.11] - 2026-03-21

Added

• [helpers]: Add support for helpers domains (automation, scene, script, input_boolean, input_button) in device entities and split entities.
• [button]: Add domain button in individual entities, device entities and split entities.

Changed

• [platform]: Require Matterbridge v.3.7.0.
• [package]: Update dependencies.
• [package]: Bump package to automator v.3.1.3.
• [package]: Bump typescript-eslint to v.8.57.1.
• [devcontainer]: Update Dev Container configuration.
• [devcontainer]: Add postStartCommand to the Dev Container configuration.
• [package]: Refactor build.yml to use matterbridge dev branch for push and main for pull requests.
• [package]: Add type checking script for Jest tests.
• [package]: Update actions versions in workflows.
• [package]: Bump eslint to v.10.1.0.

Release 1.0.10

[1.0.10] - 2026-03-09

Breaking Changes

• [split]: The names of split entities may now be chosen using this logic:

  • Friendly name => Name => Original name (i.e. Computer Plug Child Lock). This avoids most duplicate-name issues, but the name will probably be truncated to 32 characters.
  • Name => Original name => Friendly name (i.e. Child Lock). This will probably create duplicate-name issues unless you change the name.

  If you change this option, check the whiteList and blackList if you use them.

Added

• [report]: A new file report.log is generated in the Matterbridge/matterbridge-hass directory. It contains the list of devices and entities, highlighting whether they are in filterByArea, have filterByLabel, or are in splitEntities.
• [config]: Add the splitNameStrategy config option to select the naming strategy for split entities: Entity name (i.e. Child Lock) or Friendly name (i.e. Computer Plug Child Lock).

Changed

• [package]: Update dependencies.
• [package]: Bump package to automator v.3.1.2.
• [package]: Bump eslint to v.10.0.3.

Fixed

• [mireds]: Fix the maximum mireds value. Thanks jvmahon (https://github.com/Luligu/matterbridge/issues/523).
• [split]: Fix the name priority for split entities.
• [filter]: Ignore area for device entities and split entities.

Release 1.0.9

[1.0.9] - 2026-03-06

Breaking Changes

• [applyFiltersToDeviceEntities]: Remove applyFiltersToDeviceEntities config option and use unified logic. A device is exposed if it is in a valid area or has a valid label or has any entities that are in a valid area or have a valid label. Thanks trilu2000, Trushna and itsgreat2misha (#171).

  If you want to expose all entities, use the filters on the device and don't use them on its entities.

  If you want to expose only some entities, don't use the filters on the device and apply them only to the entities you want to expose.

• [logger]: The logger is no more in debug mode as default: you need to set debug for the plugin in the config to have a log suitable for debug.

Changed

• [package]: Update dependencies.
• [package]: Bump package to automator v.3.1.1.
• [package]: Add @eslint/json.
• [package]: Add @eslint/markdown.
• [package]: Add CONTRIBUTING.md.
• [package]: Add STYLEGUIDE.md.

Fixed

• [logger]: Fix logger level. Thanks Reimer Prochnow (Luligu/matterbridge#521).

Release 1.0.8

How to use filters and select

Read the explanation here.

Naming issues on the controller side explained

For naming issues (especially upsetting with Alexa), read the explanation and the solution here.

[1.0.8] - 2026-02-27

Dev Breaking Changes

• [devContainer]: Add the new dev container setup.
• [devContainer]: Add the new reflector dev container setup.
• [devContainer]: Add the guide to pair Matterbridge with Dev Container

Added

• [adaptive]: Add logic to send attributes updates in turn_on only when the controller may (!) have modified them while the light was off. Thanks nixpare and itsgreat2misha (#169).

Changed

• [package]: Update dependencies.
• [package]: Bump package to automator v.3.1.0.
• [package]: Bump eslint to v.10.0.2.
• [package]: Bump typescript-eslint to v.8.56.1.
• [package]: Replace eslint-plugin-import with eslint-plugin-simple-import-sort.
• [eslint]: Use minimatch in ignores.

Release 1.0.7

[1.0.7] - 2026-02-19

Added

• [guide]: Add a guide about using filters and select here.
• [names]: Add a warning message in the logs and on the frontend with the total number of devices and entities discarded due to duplicate names.
• [names]: Add a warning message in the logs and on the frontend with the total number of devices and entities whose name exceeds Matter’s 32-character limit.
• [create]: Add an error message in the logs and on the frontend with the total number of devices and entities that failed to be created.
• [group]: Add the link on the frontend for group helpers (platform = group).
• [unavailable]: Add check for not provided entities (state = unavailable, restored = true): they are ignored.
• [config]: Check if all splitEntities in the config exist.
• [update]: Add queue to fast updates: a new update stops the older ones that are still executing.

Changed

• [package]: Update dependencies.
• [package]: Bump package to automator v.3.0.8.
• [package]: Bump node-ansi-logger to v.3.2.0.
• [package]: Bump node-persist-manager to v.2.0.1.
• [package]: Bump eslint to v.10.0.0.
• [config]: Improve descriptions of fields in the config.

Fixed

• [create]: When a device creation fails, the device is now removed from the select (Devices panel on the Home page).