Merge pull request #64 from Luligu/dev

Release 2.1.14

CHANGELOG.md

@@ -4,6 +4,21 @@ If you like this project and find it useful, please consider giving it a star on
 
 All notable changes to this project will be documented in this file.
 
+## [2.1.14] - 2024-08-29
+
+### Added
+
+- [config]: Added parameter postfixHostname (default true). If you change it, the controllers will remove and recreate all the devices! (https://github.com/L2jLiga)
+
+### Changed
+
+- [package]: Updated dependencies.
+- [package]: Updated imports.
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="./yellow-button.png" alt="Buy me a coffee" width="120">
+</a>
+
 ## [2.1.13] - 2024-08-22
 
 ### Changed

README.md

@@ -121,7 +121,7 @@ The unregisterOnShutdown option allows to remove from the bridge all z2m devices
 
 These are the default vules:
 
-```
+```json
 {
   "name": "matterbridge-zigbee2mqtt",
   "type": "DynamicPlatform",
@@ -137,13 +137,14 @@ These are the default vules:
   "lightList": [],
   "outletList": [],
   "featureBlackList": [],
-  "deviceFeatureBlackList": {}
+  "deviceFeatureBlackList": {},
+  "postfixHostname": true
 }
 ```
 
 If you want to exclude "device_temperature" for all the devices, add to the config
 
-```
+```json
 {
   ...
   "featureBlackList": ["device_temperature"]
@@ -154,7 +155,7 @@ If you want to exclude "device_temperature" for all the devices, add to the conf
 If you want to exclude "temperature" and "humidity" for the device "My motion sensor" and
 "device_temperature" only for the device "My climate sensor", add to the config
 
-```
+```json
 {
   ...
   "deviceFeatureBlackList": {
@@ -165,6 +166,17 @@ If you want to exclude "temperature" and "humidity" for the device "My motion se
 }
 ```
 
+By default matterbridge uses hostname in order to make entities unique, however in some cases
+you may not want this behavior. You can use "postfixHostname" boolean flag to disable this behavior:
+
+```json
+{
+    ...
+    "postfixHostname": false
+    ...
+}
+```
+
 From the release 1.2.14 of Matterbridge you can edit the config file directly in the frontend.
 
 You can edit the config file manually if you prefer:

matterbridge-zigbee2mqtt.schema.json

@@ -60,7 +60,7 @@
       }
     },
     "switchList": {
-      "description": "The devices in the list will be exposed like switches. (don't use it for Alexa, use lightList or outletList instead)",
+      "description": "The devices in the list will be exposed like switches (don't use it for Alexa, use lightList or outletList instead).",
       "type": "array",
       "items": {
         "type": "string"
@@ -97,6 +97,11 @@
         }
       }
     },
+    "postfixHostname": {
+      "description": "Unique postfix added to each device identifier to avoid collision with other instances (you may loose the configuration of the devices in your controller when changing this value).",
+      "type": "boolean",
+      "default": true
+    },
     "debug": {
       "description": "Enable the debug for the plugin (development only)",
       "type": "boolean",