Zigbee2MQTT Nodes for Node-RED
This project contains Node-RED nodes that allow you to build Smart Home scenarios with your Zigbee devices connected to ZigBee2MQTT.
Available Nodes
Many nodes are available right now, and there are still new node ideas that will be added in the near future. Here is a list of the currently available ones:
- generic-lamp
- send-messages
- override-nodes
- button-switch
- scene-in
- scene-selector
- ota-node
- bridge-log
- And many more for sensors and remotes...
Getting started
Have a look at the getting started guide.. All you need are some already paired Zigbee lamps and an installed Node-RED. What are you waiting for? Find out now how easy it is to get started.
Documentation
The documentation for the project is located in the docs folder.
You need some addition help?
Join the Discord server for a more in depth support or problems that aren't metioned anywhere :)
You want to contribute?
That's easy! Feel free to post suggestions, adding documentation or add new features. Every support is welcome!
If you feel very generous and want to contribute with coffee, you sure can:
Changelog
Release: 0.20.0 3 Jan 2024
Features:
- Add support for Ikea Styrbar (E2001) remote control
Bug fixes:
- Setting brightnes to 0 did not turn it off. Now it will override the state to "OFF"
- Fixed Scenic Friend of Hue switch. Property names has changed between versions
Release: 0.19.6 13 Nov 2022
Features:
Bug fixes:
- Bridge did not connect in newer z2m versions because z2m changed the format of 'bridge/state' from string to JSON.
- Shelly 2.5 did not connect to the broker, because it used an old configuration node.
- Shelly 2.5 node did not unsubscribe from the old channel with no full redeploy.
Behind the scenes
- Add mocha and first-unit test examples
- Add integration tests to test with a real MQTT broker
Release: 0.19.5 - 14 Mar 2022
Bug fixes:
- Hosting the Node-RED UI under a different root path than
http://localhost:1880/resulted in failing web requests to load the device list. For example, when the UI was set tohttp://localhost:1880/adminor Node-RED was running as a Home Assistant plugin. - Fixed a bug where the configured device name gets deleted, when the device list couldn't be loaded. Further details in #105 and #119
Release: 0.19.4 - 01 Jan 2022
Happy new year to all!
Bug fixes:
- @itupsk fixed the issue #114, where we forgot a null check on the ikea bugfix in the last release. Thanks a lot!
- Also fixed the same issue in hue, scenic and sonoff devices
Release: 0.19.3 - 30 Dec 2021
Features:
- Documented additional settings for upgrading to mosquitto 2.0 in the getting started guide.
- Documented Mirek scale.
Bug fixes:
- Not set property on Ikea Remote device caused a complete Node-Red restart
- Not set property on Hue Remote device caused a complete Node-Red restart
- Preventive measure: Check action for empty string in scenic remote and sonnoff buttons
Release: 0.19.2 - 12 Mar 2021
Bug fixes:
- Local node-red installation with nodejs 12 had a problem to load the node-red dependency. Removed it for now as it is only used for logging.
Release: 0.19.1 - 8 Mar 2021
Bug fixes:
- Better handling for invalid MQTT messages from z2m. Sometimes a required/expected property is missing or empty which caused an error.
- Hue Dimmer switch crashed NodeRED because the power status with no action came with no action.
Behind the scenes
- Removed some unnecessary files from the package, reducing the size from 324 kB to 229 kB
- Removed vulnerable dependencies
- Updated and thinned out dependencies so the installation will be faster
- Dev feature: Cleaned up npm build scripts so there are no warnings, and they behave the same on Windows, Linux, and macOS.
Release: 0.19.0 - 23 Jan 2021
Features:
- Two new example flows, from the getting started guide
- Documentation overview page
- Documented examples
- Show switch to manual button if the device-list request failed.
- Added
deviceNameto the ouput of the climate-sensor. Resolves #75 - Added
separateOuputsoption the the climate sensor. Resolves #75
Older changelogs
You can find all the release notes at the Release-Page