node-red-contrib-huemagic 2.8.6 → 4.0.2

package/README.md

@@ -1,837 +1,878 @@
-[![Hue Magic Logo](https://gistcdn.githack.com/Foddy/062045775c28f5993ad646aba80e678c/raw/dd9081c45c947d997bf4c03603f12d5c9b963a12/huemagic.svg)](https://flows.nodered.org/node/node-red-contrib-huemagic)
+[![Hue Magic Logo](https://gist.githubusercontent.com/Foddy/9b647b910d03a31cee40f97c3988dd1c/raw/7ee635bd958ad04d7ba53c6c40ec401f879bffc2/huemagic-logo.svg)](https://flows.nodered.org/node/node-red-contrib-huemagic)
 
 # HueMagic - Philips Hue nodes for Node-RED
 
-[![Travis](https://img.shields.io/travis/Foddy/node-red-contrib-huemagic.svg?style=flat-square)](https://github.com/foddy/node-red-contrib-huemagic/) [![Dependencies](https://david-dm.org/foddy/node-red-contrib-huemagic.svg?style=flat-square)](https://david-dm.org/foddy/node-red-contrib-huemagic) [![npm](https://img.shields.io/npm/dt/node-red-contrib-huemagic.svg?style=flat-square)](https://www.npmjs.com/package/node-red-contrib-huemagic) [![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=LUQ7CWBWQ3Q4U) [![npm](https://img.shields.io/npm/v/node-red-contrib-huemagic.svg?style=flat-square)](https://github.com/foddy/node-red-contrib-huemagic/) [![GitHub license](https://img.shields.io/badge/license-Apache%202-blue.svg?style=flat-square)](https://raw.githubusercontent.com/Foddy/node-red-contrib-huemagic/master/LICENSE)
+[![npm](https://img.shields.io/npm/v/node-red-contrib-huemagic.svg?style=flat-square)](https://github.com/foddy/node-red-contrib-huemagic/) [![GitHub license](https://img.shields.io/badge/license-Apache%202-blue.svg?style=flat-square)](https://raw.githubusercontent.com/Foddy/node-red-contrib-huemagic/master/LICENSE) [![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=LUQ7CWBWQ3Q4U) [![npm](https://img.shields.io/npm/dt/node-red-contrib-huemagic.svg?style=flat-square)](https://www.npmjs.com/package/node-red-contrib-huemagic)
 
-HueMagic provides several input and output nodes for Node-RED and is the most in-depth and easy to use solution to control Philips Hue bridges, lights, groups, scenes, rules, taps, switches, buttons, motion sensors, temperature sensors and Lux sensors.
+HueMagic provides several input and output nodes for Node-RED and is the most in-depth and easy to use solution to control Philips Hue bridges, lights, groups, scenes, rules, buttons/switches, motion sensors, temperature sensors and light level sensors.
 
 ### Features
 * Simple and comprehensive control of the Hue Bridge and connected devices
 * Automatic discovery of Philips Hue bridges as well as devices, scenes & groups…
-* Supports the output and input of multiple color code definitions *(HEX, RGB & human readable color names)*
-* Supports the temporary activation and deactivation of rules on the Hue Bridge
+* Output and input of multiple color code definitions *(HEX, RGB & human readable color names)*
+* Automatic color temperature & brightness setting based on the current time
 * Event-based status messages for all devices connected to the Hue Bridge
-* Real-time status messages in the Node-RED UI
-* Supports virtual pressing of the button on the Hue Bridge (Link Button)
-* Programmatic pairing of new devices without app enforcement (TouchLink)
+* Virtual pressing of the Hue Bridge button (Link Button)
+* Pairing of new devices without app enforcement (TouchLink)
 * Automatic firmware updates to the Hue Bridge and connected devices
-* Supports activating / deactivating of motion sensors
-* Easy to use alarm and colorloop effects on light bulbs and whole groups
-* A large selection of animations and the options to apply custom animations
+* Activating / deactivating of sensors & rules on the Hue Bridge
+* Extended alarm and colorloop effects on light bulbs and whole groups
+* A large selection of animations and the option to create custom animations
 * Additive state settings on all nodes with multiple commands
-* Can change states even if the corresponding devices are offline
-* Localized in English & German
+* Change states even if the corresponding devices are offline or turned off
+* Real-time status messages for each node & in the Node-RED UI (SSE)
+* Uses the latest CLIP/v2 API version of the Philips Hue Bridge
+* Extensively documented in English & German
 
 ### Installation
-HueMagic was written for **Node.js 12+** and Node-RED v1.1.3+. It supports Philips Hue API version v1.19.0+.
-_Please make sure, that you deactivate / remove other Philips Hue related Node-RED nodes before installing HueMagic!_
+HueMagic was written for **Node.js 14+** and **Node-RED v2.1+**. It supports the square-shaped Hue Bridge with the **FW 1948086000+** or higher. You can install HueMagic directly via the [Node-RED Palette Manager](https://nodered.org/docs/user-guide/editor/palette/manager) or manually using [yarn / npm](https://nodered.org/docs/user-guide/runtime/adding-nodes).
 
 `npm install node-red-contrib-huemagic`
 
+_Please make sure that you deactivate other Hue-related nodes in Node-RED and meet the minimum requirements of Node.js and the Philips Hue Bridge firmware!_
+
 ### Available Nodes
 
-- [Hue Bridges](#hue-bridges)
+- [Hue Bridge](#hue-bridge)
 - [Hue Magic](#hue-magic)
-- [Hue Lights](#hue-lights)
-- [Hue Groups](#hue-groups)
-- [Hue Scenes](#hue-scenes)
-- [Hue Taps](#hue-tap)
-- [Hue Wireless Dimmer Switches](#hue-switch)
-- [Hue Buttons](#hue-button)
-- [Hue Motion Sensors](#hue-motion-sensor)
-- [Hue Temperature Sensors](#hue-temperature-sensor)
-- [Hue Lux Sensors](#hue-lux-sensor)
-- [Hue Rules](#hue-rules)
-
-## Hue Bridges
-The Hue Bridge node keeps the Hue Bridge firmware and connected devices up-to-date and provides more information and setup options for the bridge.
-
-![Hue Bridge Example](https://user-images.githubusercontent.com/5302050/62820502-4974e780-bb65-11e9-8f05-4078d77eec5e.png)
+- [Hue Light](#hue-light)
+- [Hue Group](#hue-group)
+- [Hue Scenes](#hue-scene)
+- [Hue Buttons](#hue-buttons)
+- [Hue Motion](#hue-motion)
+- [Hue Temperature](#hue-temperature)
+- [Hue Brightness](#hue-brightness)
+- [Hue Rule](#hue-rule)
+
+### Examples
+
+HueMagic provides a large selection of full featured sample flows for all nodes. You can find these examples in the "[examples](https://github.com/Foddy/node-red-contrib-huemagic/tree/master/examples)" folder on GitHub or directly in Node-RED. To import a full featured example into your Node-RED interface, click on the Node-RED menu icon, then select "Import" and navigate to "Examples" in the sidebar of the popup. Then select the HueMagic folder and your desired node to import a sample flow.
+
+<img alt="Instructions to import examples in Node-RED" src="https://user-images.githubusercontent.com/5302050/148696808-f730ad36-8d0b-4b5b-99b2-1917831f8916.gif" width="100%">
+
+## Hue Bridge
+The "Hue Bridge" node is a universal node that can output all settings of the bridge and status messages from other nodes.
+
+![Hue Bridge Example](https://user-images.githubusercontent.com/5302050/148696503-428cf1d0-8376-49fe-b677-979070fc92b9.png)
+
+### Node-RED Setup Instructions
+
+First select the desired Hue Bridge. You can optionally deactivate all automatic status messages for this node by clicking the setting “Skip global device updates / messages on this node”. The node will then no longer issue device updates.
+
+Alternatively, you can also choose whether the initialization messages of all nodes should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message from all resources connected to the bridge after each deployment.
 
 ### Get settings / status
-Retrieves the current status / settings of the bridge by injecting any input value.
-
-| Property | Type |                     Information                     |
-|:--------:|:----:|:---------------------------------------------------:|
-| **any**  | any  | Triggers an output of the current status / settings |
-
-### Enable TouchLink scan
-Use TouchLink to pair new devices or old devices after a bridge reset. This is commonly known in the community as "Lamp stealer". Pass the **touchLink** property to **msg.payload**.
-
-|    Property   |             Type             |       Information      |
-|:-------------:|:----------------------------:|:----------------------:|
-| **touchLink** | boolean (any value accepted) | Pairs lights / devices |
-
-### Fetch all devices and resources
-Use the Fetch command to retrieve various information from the Hue Bridge when needed. Pass the **fetch** property to **msg.payload**.
-
-|       Property       |  Type  |                                                        Information                                                        |
-|:--------------------:|:------:|:-------------------------------------------------------------------------------------------------------------------------:|
-|       **users**      | string | Returns an array of User objects in msg.users & bridge information in msg.info                                            |
-|      **lights**      | string | Returns an array of Light objects in msg.lights & bridge information in msg.info                                          |
-|      **groups**      | string | Returns an array of Group objects in msg.groups & bridge information in msg.info                                          |
-|      **sensors**     | string | Returns an array of Sensor objects in msg.sensors & bridge information in msg.info                                        |
-|      **scenes**      | string | Returns an array of Scene objects in msg.scenes & bridge information in msg.info                                          |
-|       **rules**      | string | Returns an array of Rule objects in msg.rules & bridge information in msg.info                                            |
-|     **schedules**    | string | Returns an array of Schedule objects in msg.schedules & bridge information in msg.info                                    |
-|   **resourceLinks**  | string | Returns an array of ResourceLink objects in msg.resourceLinks & bridge information in msg.info                            |
-|     **timeZones**    | string | Returns an array of all available time zones in msg.timeZones & bridge information in msg.info                            |
-| **internetServices** | string | Returns an object of all available internet services information in msg.internetServices & bridge information in msg.info |
-|      **portal**      | string | Returns an object of all available portal information in msg.portal & bridge information in msg.info                      |
-
-### Hue Bridge Settings
-Changes the Hue Bridge settings based on the passed in **msg.payload.settings** values of:
-
-|      Property     |   Type  |                   Information                  |
-|:-----------------:|:-------:|:----------------------------------------------:|
-| **name**          | string  | Name of the bridge                             |
-| **zigbeeChannel** | int     | ZigBee channel (for communicating with lights) |
-| **ipAddress**     | string  | IP address                                     |
-| **dhcpEnabled**   | boolean | Whether or not DHCP is enabled                 |
-| **netmask**       | string  | Netmask                                        |
-| **gateway**       | string  | Gateway                                        |
-| **proxyAddress**  | string  | Proxy address                                  |
-| **proxyPort**     | string  | Proxy port                                     |
-| **timeZone**      | string  | Time zone                                      |
-
-### Hue Bridge Events
-The event message that the bridge sends contains the following data in the **msg.payload** object:
-
-|          Property         |      Type     |                                                       Information                                                       |
-|:-------------------------:|:-------------:|:-----------------------------------------------------------------------------------------------------------------------:|
-| **id**                    | string        | Unique ID of the Hue Bridge                                                                                             |
-| **name**                  | string        | Name of the bridge                                                                                                      |
-| **factoryNew**            | boolean       | Whether or not the bridge is factory new                                                                                |
-| **replacesBridgeId**      | string / null | Replaces bridge id (for migrating from old bridges)                                                                     |
-| **dataStoreVersion**      | string        | Data store version                                                                                                      |
-| **starterKitId**          | string        | Name of the starterkit created in the factory                                                                           |
-| **softwareVersion**       | string        | Software version of the bridge                                                                                          |
-| **apiVersion**            | string        | API version of the bridge                                                                                               |
-| **zigbeeChannel**         | int           | ZigBee channel (for communicating with lights)                                                                          |
-| **macAddress**            | string        | MAC address                                                                                                             |
-| **ipAddress**             | string        | IP address                                                                                                              |
-| **dhcpEnabled**           | boolean       | Whether or not DHCP is enabled                                                                                          |
-| **netmask**               | string        | Netmask                                                                                                                 |
-| **gateway**               | string        | Gateway                                                                                                                 |
-| **proxyAddress**          | string        | Proxy address                                                                                                           |
-| **proxyPort**             | string        | Proxy port                                                                                                              |
-| **utcTime**               | string        | UTC time of the bridge                                                                                                  |
-| **timeZone**              | string        | Time zone                                                                                                               |
-| **localTime**             | string        | Local time of the bridge                                                                                                |
-| **portalServicesEnabled** | boolean       | Whether or not portal services are enabled                                                                              |
-| **portalConnected**       | boolean       | Whether or not portal is connected                                                                                      |
-| **linkButtonEnabled**     | boolean       | Whether or not link button is enabled                                                                                   |
-| **touchlinkEnabled**      | boolean       | Whether or not TouchLink is enabled                                                                                     |
-| **model**                 | object        | The model object of the bridge includes model specific information like the model.id, model.manufacturer and model.name |
-
-### Global update events
-The bridge also sends events when a certain active resource (lights, groups, sensors, etc.) changes its status.
-
-|     Property    |  Type  |                                          Information                                          |
-|:---------------:|:------:|:---------------------------------------------------------------------------------------------:|
-| **msg.updated** | object | The whole object of the device (check docs)                                                   |
-| **msg.type**    | string | Can be one of the following: light, group, rule, motion, brightness, temperature, switch, tap |
+
+Outputs the current status / settings of the bridge as soon as the following message has been sent to the node. Alternatively, you can also press the button in the Node-RED interface without having to pass a message to the node beforehand.
+
+|Property|Description|
+|--|--|
+| payload (boolean) | Returns the current status of the bridge |
+
+### Trigger TouchLink scan
+
+You can couple new or old devices to the bridge using a "TouchLink scan" (e.g. after a reset). To do this, transfer the object `msg.payload` with the following content:
+
+|Property|Description|
+|--|--|
+| touchLink (boolean) | Couples old or new devices with the bridge |
+
+### Get all devices and resources
+
+With the "fetch" command you can output a list of specific devices that are currently connected to the bridge. To do this, transfer the object `msg.payload` with the following content:
+
+|Property|Description|
+|--|--|
+| fetch (string / array [string, ...]) | Can accept `light`, `group`, `button`, `motion`, `temperature`, `light_level` or `rule` as value(s) |
+
+### Change Hue Bridge settings
+
+You can use the following command to change specific settings on the bridge. Please note that changing the network settings requires reconfiguring the bridge on HueMagic. Transfer the object `msg.payload.settings` with the following setting options to the node:
+
+|Property|Description|
+|--|--|
+| name (string) | Changes the name of the bridge and must contain at least 4 to a maximum of 16 characters |
+| zigbeeChannel (int) | Changes the current ZigBee channel (either `11`, `15`, `20`, `25` or `0`) |
+| ipAddress (string) | Changes the IP address in the network settings |
+| dhcpEnabled (boolean) | `true`, activates DHCP in the network settings, `false`, deactivates the setting |
+| netmask (string) | Changes the network mask in the network settings |
+| gateway (string) | Specifies the gateway in the network settings |
+| proxyAddress (string) | Sets a proxy address in the network settings |
+| proxyPort (string / int) | Specifies the port of the proxy in the network settings |
+| timeZone (string) | Changes the currently set time zone on the bridge |
+
+### Status messages from the node
+
+The status reports of the "Hue Bridge" node are dynamic. Although they follow a certain pattern, their output can vary depending on what action has just been carried out on the node.
+
+#### Status object under `msg.payload`
+
+|Property|Description|
+|--|--|
+| id (string) | Unique ID of the Hue Bridge |
+| name (string) | Currently set name |
+| factoryNew (boolean) | Indicator whether the bridge is brand new |
+| replacesBridgeId (string / boolean) | Outputs the old bridge ID (if a migration was carried out) or outputs `false` |
+| dataStoreVersion (string) | Version of the data store |
+| starterKitId (string / boolean) | Name of the starter kit created in the factory or `false` |
+| softwareVersion (string) | Software version of the bridge |
+| apiVersion (string) | API version of the bridge |
+| zigbeeChannel (int) | Currently used ZigBee channel |
+| macAddress (string) | MAC address of the bridge |
+| ipAddress (string) | IP address of the bridge |
+| dhcpEnabled (boolean) | Indicates whether DHCP is enabled |
+| netmask (string) | Netmask of the bridge |
+| gateway (string) | Gateway of the bridge |
+| proxyAddress (string / boolean) | Currently used proxy address or `false` |
+| proxyPort (string) | Currently used proxy port |
+| utcTime (string) | UTC time on the bridge |
+| timeZone (string) | Currently set time zone on the bridge |
+| localTime (string) | Local time zone |
+| portalServicesEnabled (boolean) | Indicates whether portal services are enabled |
+| portalConnected (boolean) | Indicates whether the bridge is connected to the portal |
+| linkButtonEnabled (boolean) | Indicates whether the link button is enabled |
+| touchlinkEnabled (boolean) | Indicates whether TouchLink is enabled |
+| autoUpdatesEnabled (boolean) | Indicates whether the HueMagic will automatically check for updates |
+| users (array [object, ...]) | List of all users on the bridge (array with objects) |
+| updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
+| model (object) | Contains the model information of the bridge under `id`, `manufacturer` and `name` |
+
+#### Fetch results under `msg.results` (optional)
+
+If the "fetch" command has been used on the node, the bridge outputs the corresponding results under the `msg.results` object. The object contains the queried resource groups, which in turn contain all the corresponding resources in the form of an array.
+
+#### Global status messages under `msg.updated` (optional)
+
+Unless deactivated, the node outputs an updated status message for each resource on the bridge. The status message under * msg.updated * follows the pattern of the respective resource and varies depending on the type of device that was last updated.
+
+#### Last command under `msg.command` (optional)
+
+If the status of the node has changed via a certain command, the entire command that was executed is also output. Otherwise this object will not be output by the node.
 
 ## Hue Magic
-Use the Hue Magic node to apply animations on Hue Lights or Hue Groups. Connect the Hue Magic node to only one light or a whole group node to save API requests on the Hue Bridge. The animation previews can differ slightly from the real result on a lamp / group.
+The "Hue Magic" node can apply complex and custom animations to lights and groups.
+
+![Hue Magic Example](https://user-images.githubusercontent.com/5302050/148696508-51db24ea-722e-402c-9c49-8d728e036488.png)
 
-![Hue Magic Example](https://user-images.githubusercontent.com/5302050/71544026-68d8a980-297a-11ea-912a-789c06bcad79.png)
+### Node-RED Setup Instructions
 
-### Start / Stop animation
-Starts or stops an animation on the passed in **msg** values of:
+First give the node a name in order to clearly classify your animation in the Node-RED interface. You then have the choice between the options "Loop" and "Restore". Select the loop option if you want your animation to run endlessly on a light or group until you manually stop it. If you want to restore the previous state of the target resource (light / group) after the animation has ended, check the "Restore" option. Otherwise the last frame of the animation remains on the respective resource.
 
-|   Property  |   Type  |                       Information                       |
-|:-----------:|:-------:|:-------------------------------------------------------:|
-| **payload** | boolean | True to start the animation, false to stop              |
+Below you can choose from pre-made animations from HueMagic. Click on your desired animation to set it.
 
 ### Included animations
-Choose one of the included animations to apply to a Hue Light or Hue Group node. Contributions are welcomed! If you have created your own animation that you would like to share with others, add it at `/huemagic/animations/XXX-youranimationname.json` and create a pull request. Take a look at this directory for structure help.
+Choose one of the included animations to apply to a Hue Light or Hue Group node.
 
 ![Some included animations](https://user-images.githubusercontent.com/5302050/71556018-30e16d00-2a33-11ea-8c03-45211767ee98.gif)
 
-### Custom animations
-Alternatively, you can create and use your own animations. To do this, create an **array** and pass it to **msg.payload.steps** with the following parameters.
+### Start / stop animation
+
+To play or stop an animation, pass an object with the following content to the node:
+
+|Property|Description|
+|--|--|
+| payload (boolean) | `true`, starts the animation, `false`, stops the animation |
+
+### Own animations
+
+If you pass your own animation to the node, the preselected, pre-defined animation (if set) will be temporarily replaced by yours. Own HueMagic animations are a sequence of commands that have been combined in an array. Each array element forms a step - whereby a step can also consist of several frames (transition effects).
+
+Create an `array` with the respective animation steps in the form of an object and transfer it to the HueMagic node under `msg.payload.steps`.
+
+|Property|Description|
+|--|--|
+| delay (int) | Number of milliseconds to wait until this step is carried out |
+| animation (object) | The object contains the action(s) to be carried out in this step. Identical parameters as for the "Hue Light" & "Hue Group" nodes |
 
-|    Property   |  Type  |                                                  Information                                                 |
-|:-------------:|:------:|:------------------------------------------------------------------------------------------------------------:|
-| **delay**     | int    | Execute this frame after the delay (in ms)                                                                   |
-| **animation** | object | Insert all parameters that should be animated here. Supports all values of "Hue Light" and "Hue Group" node. |
+If you have created your own animation that you would like to share with others, add it at `/huemagic/animations/XXX-youranimationname.json` and create a pull request. Take a look at [this directory](https://github.com/Foddy/node-red-contrib-huemagic/tree/master/huemagic/animations) for structure help.
+
+### Example of your own animation
+
+This example shows what a simple animation could look like. In the first step, the delay of 500 milliseconds is waited for. The color of the light is then slowly changed to red over a period of one second. As soon as the light has completely changed to red, the second step is carried out, which also has a delay of 500 milliseconds. Finally the color changes to blue.
+
+If you have set the animation to play indefinitely, this process is repeated indefinitely until you manually stop the animation or redeploy the node.
+
+Pass the following object in `msg.payload` to play the example animation.
+
+    {
+        "animate": true,
+        "steps": [
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#FF0000",
+                    "transitionTime": 1
+                }
+            },
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#0000FF",
+                    "transitionTime": 1
+                }
+            }
+        ]
+    }
 
 ### Special commands
-Sometimes it makes sense for animations to be played out in disorder. For example, to imitate fire more realistically. To do this, create an object and pass it to **msg.payload.specials** with the following parameters.
-
-|     Property    |   Type  |          Information          |
-|:---------------:|:-------:|:-----------------------------:|
-| **randomOrder** | boolean | Execute steps in random order |
-
-## Hue Lights
-Use the Hue Light node to control the lights and receive light bulb events.
-
-![Hue Light Example](https://user-images.githubusercontent.com/5302050/62820499-48dc5100-bb65-11e9-962f-a1e1a1de21df.png)
-
-### Turn on / off (simple mode)
-Changes the light on / off state based on the passed in **msg** values of:
-
-|   Property  |   Type  |                                        Information                                        |
-|:-----------:|:-------:|:-----------------------------------------------------------------------------------------:|
-| **payload** | boolean | Will turn on or turn off the light with its previous configuration (color and brightness) |
-
-### Turn On / Off (extended mode)
-Changes the light state, effect, color, brightness and other states based on the passed in **msg.payload** values of:
-
-|         Property        |        Type        | Information                                                                                                                       |
-|:-----------------------:|:------------------:|-----------------------------------------------------------------------------------------------------------------------------------|
-|          **on**         |       boolean      | Will turn on or turn off the light with its previous configuration (color and brightness)                                         |
-|      **brightness**     |         int        | Optionally configurable brightness of the light in percent (0-100)                                                                |
-|   **brightnessLevel**   |         int        | Optionally configurable brightness of the light (0-254)                                                                           |
-| **incrementBrightness** |         int        | Increment brightness by given percentage value                                                                                    |
-| **decrementBrightness** |         int        | Decrement brightness by given percentage value                                                                                    |
-|         **rgb**         | array[int,int,int] | Optionally configurable RGB color value of the light bulb. You don't need to pass the RGB value if you already passed a HEX value |
-|         **hex**         |       string       | Optionally configurable HEX color value of the light bulb. You don't need to pass the HEX value if you already passed a RGB value |
-|        **color**        |       string       | Optionally configurable human readable color name in english like "red" or "random" for a random color                            |
-|        **image**        |       string       | Optionally configurable image path (remote or local) to apply the most dominant color to the light                                |
-|    **transitionTime**   |        float       | Optionally configurable temporary value which eases transition of an effect (value in seconds, 0 for instant, 5 for five seconds) |
-|      **colorloop**      |   float / boolean  | Optionally configurable color loop effect. Float = disables the effect after x seconds / Boolean to turn on / off the effect      |
-|      **colorTemp**      |         int        | Optionally configurable color temperature of the light from 153 to 500                                                            |
-| **incrementColorTemp**  |         int        | Increment/decrement color temperature by given value                                                                              |
-|      **saturation**     |         int        | Optionally configurable color saturation of the light in percent (from 0 to 100)                                                  |
-|       **status**        |         any        | Returns the current status message of the node without taking any action                                                          |
-
-### Toggle on / off (auto)
-Turns the light on or off depending on the current state based on the passed in **msg.payload** value of:
-
-|   Property  |   Type  |                                        Information                                        |
-|:-----------:|:-------:|:-----------------------------------------------------------------------------------------:|
-| **toggle** | any | Will turn on or turn off the light with the previous configuration (color and brightness) |
-
-### Special Alert Effect
-Plays an alert effect based on the passed in **msg.payload** values of:
-
-|  Property |        Type        | Information                                                                                                                                          |
-|:---------:|:------------------:|------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **alert** |  int *(required)*  | Configurable amount of seconds to play the alert effect (max 30) |
-|  **rgb**  | array[int,int,int] | Optionally configurable RGB color value of the alert effect. You don't need to pass the RGB value if you already passed a HEX value                  |
-|  **hex**  |       string       | Optionally configurable HEX color value of the alert effect. You don't need to pass the HEX value if you already passed a RGB value                  |
-| **color** |       string       | Optionally configurable human readable color name in english like "red" or "random" for a random color effect                                                          |
-
-
-### Light Events
-The event message that the light bulb sends contains the following data in the **msg.payload** object. Events will only be sent if the light bulb state is changed.
-
-|       Property      |        Type        |                         Information                        |
-|:-------------------:|:------------------:|:----------------------------------------------------------:|
-|        **on**       |       boolean      | True for on, false for off                                 |
-|    **brightness**   |         int        | Current brightness of the light bulb in percent            |
-| **brightnessLevel** |         int        | Current brightness of the light bulb (0-254)               |
-|       **rgb**       | array[int,int,int] | Current RGB color value of the light bulb (if supported)   |
-|       **hex**       |       string       | Current HEX color value of the light bulb (if supported)   |
-|      **color**      |       string       | Current color name of the light bulb (if supported)        |
-|    **colorTemp**    |         int        | Current color temperature of the light bulb (if supported) |
-|     **updated**     |       string       | ISO 8601 date string of the last light state update        |
-
-### Additional Light Bulb Information
-The event message that the light bulb sends also contains the following data in the **msg.info** object.
-
-|       Property      |  Type  | Information                                                                                                                                                              |
-|:-------------------:|:------:|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-|        **id**       |   int  | Numerical id of the light as registered on the bridge                                                                                                                    |
-|     **uniqueId**    | string | Unique Id of the light (typically hardware id)                                                                                                                           |
-|       **name**      | string | Name for the light                                                                                                                                                       |
-|       **type**      | string | Type of light (e.g. Extended Color Light, Dimmable Light)                                                                                                                |
-| **softwareVersion** |  float | Software version of the light                                                                                                                                            |
-|      **model**      | object | The model object of the light includes model specific information like the model.id, model.manufacturer, model.name, model.type, model.colorGamut and model.friendsOfHue |
-
-### Universal Mode (optional)
-Defines the light Id on the Hue Bridge manually if not configured in the node properties (deactivates light update events):
-
-|    Property   | Type |               Information              |
-|:-------------:|:----:|:--------------------------------------:|
-| **msg.topic** | int  | Manual definition of the light bulb Id |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
-
-## Hue Groups
-Use the Hue Group node to control whole groups containing lights and receive group events.
-
-![Hue Group Example](https://user-images.githubusercontent.com/5302050/62820500-4974e780-bb65-11e9-9273-b564a8ca077c.png)
-
-### Turn on / off (simple mode)
-Changes the group on / off state based on the passed in **msg** values of:
-
-|   Property  |   Type  |                                                  Information                                                  |
-|:-----------:|:-------:|:-------------------------------------------------------------------------------------------------------------:|
-| **payload** | boolean | Will turn on or turn off all lights inside the group with their previous configuration (color and brightness) |
-
-### Turn On / Off (extended mode)
-Changes the group state, effect, color, brightness and other states based on the passed in **msg.payload** values of:
-
-|         Property        |        Type        | Information                                                                                                                                    |
-|:-----------------------:|:------------------:|------------------------------------------------------------------------------------------------------------------------------------------------|
-|          **on**         |       boolean      | True to turn on all the lights inside the group, false to turn them off                                                                        |
-|      **brightness**     |         int        | Optionally configurable brightness of the lights in percent (0-100)                                                                            |
-|   **brightnessLevel**   |         int        | Optionally configurable brightness of the lights (0-254)                                                                                       |
-| **incrementBrightness** |         int        | Increment brightness by given percentage value                                                                                                 |
-| **decrementBrightness** |         int        | Decrement brightness by given percentage value                                                                                                 |
-|   **ignoreOffLights**   |       boolean      | If the option is set, turned off lights in the group are ignored when "incrementBrightness / decrementBrightness" is set                       |
-|         **rgb**         | array[int,int,int] | Optionally configurable RGB color value of all lights inside the group. You don't need to pass the RGB value if you already passed a HEX value |
-|         **hex**         |       string       | Optionally configurable HEX color value of all lights inside the group. You don't need to pass the HEX value if you already passed a RGB value |
-|        **color**        |       string       | Optionally configurable human readable color name in english like "red" or "random" for a random color                                         |
-|        **image**        |       string       | Optionally configurable image path (remote or local) to apply the most dominant color to the group                                             |
-|    **transitionTime**   |        float       | Optionally configurable temporary value which eases transition of an effect (value in seconds, 0 for instant, 5 for five seconds)              |
-|      **colorloop**      |   float / boolean  | Optionally configurable color loop effect. Float = disables the effect after x seconds / Boolean to turn on / off the effect                   |
-|      **colorTemp**      |         int        | Optionally configurable color temperature of the group lights from 153 to 500                                                                  |
-| **incrementColorTemp**  |         int        | Increment/decrement color temperature by given value                                                                                           |
-|      **saturation**     |         int        | Optionally configurable color saturation of the group in percent (from 0 to 100)                                                               |
-|       **status**        |         any        | Returns the current status message of the node without taking any action                                                                       |
-
-### Toggle on / off (auto)
-Turns the lights on or off depending on the current state based on the passed in **msg.payload** value of:
-
-|   Property  |   Type  |                                        Information                                        |
-|:-----------:|:-------:|:-----------------------------------------------------------------------------------------:|
-| **toggle** | any | Will turn on or turn off all lights inside the group with their previous configuration (color and brightness) |
-
-### Special Alert Effect
-Plays an alert effect based on the passed in **msg.payload** values of:
-
-|  Property |        Type        | Information                                                                                                                                                        |
-|:---------:|:------------------:|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **alert** |  int *(required)*  | Configurable amount of seconds to play the alert effect (max 30) |
-|  **rgb**  | array[int,int,int] | Optionally configurable RGB color value of the alert effect. You don't need to pass the RGB value if you already passed a HEX value                                |
-|  **hex**  |       string       | Optionally configurable HEX color value of the alert effect. You don't need to pass the HEX value if you already passed a RGB value                                |
-| **color** |       string       | Optionally configurable human readable color name in english like "red" or "random" for a random color                                         |
-
-### Group Events
-The event message that the group sends contains the following data in the **msg.payload** object. Events will only be sent if the group state is changed.
-
-|       Property      |        Type        |                             Information                             |
-|:-------------------:|:------------------:|:-------------------------------------------------------------------:|
-|        **on**       |       boolean      | True for on, false for off                                          |
-|      **allOn**      |       boolean      | True if all lights in the group are on, false if not                |
-|      **anyOn**      |       boolean      | True if any lights in the group are on, false if none are on        |
-|    **brightness**   |         int        | Current brightness of all lights in the whole group in percent      |
-| **brightnessLevel** |         int        | Current brightness of all lights in the whole group (0-254)         |
-|       **rgb**       | array[int,int,int] | Current RGB color value of all lights in the group (if supported)   |
-|       **hex**       |       string       | Current HEX color value of all lights in the group (if supported)   |
-|      **color**      |       string       | Current color name of all lights in the group (if supported)        |
-|    **colorTemp**    |         int        | Current color temperature of all lights in the group (if supported) |
-|     **updated**     |       string       | ISO 8601 date string of the last group state update                 |
-
-### Additional Group Information
-The event message that the group sends also contains the following data in the **msg.info** object.
-
-|   Property   |  Type  |                                                                                                                                                                           Information                                                                                                                                                                           |
-|:------------:|:------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
-|    **id**    |   int  | Group Id, generated automatically by the bridge                                                                                                                                                                                                                                                                                                                 |
-| **lightIds** |  array | An array of light ids associated with the group                                                                                                                                                                                                                                                                                                                 |
-|   **name**   | string | Name for the group                                                                                                                                                                                                                                                                                                                                              |
-|   **type**   | string | Type of group (e.g. LightGroup, Luminaire, LightSource, Room)                                                                                                                                                                                                                                                                                                   |
-|   **model**  | object | [Huejay](https://github.com/sqmk/huejay) *(the API behind HueMagic)* maintains a list of Philips Hue supported luminaire models. The Group model attribute returns optionally a GroupModel object. This object contains more information about the model like the model.id, model.manufacturer, model.name, model.type, model.colorGamut and model.friendsOfHue |
-
-### Universal Mode (optional)
-Defines the group Id on the Hue Bridge manually if not configured in the node properties (deactivates group update events):
-
-|    Property   | Type |            Information            |
-|:-------------:|:----:|:---------------------------------:|
-| **msg.topic** | int  | Manual definition of the group Id |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
-
-## Hue Scenes
-Use the Hue Scene node to recall / activate preconfigured scenes on the bridge and receive scene information.
-
-![Hue Scene Example](https://user-images.githubusercontent.com/5302050/62797032-f6565280-bada-11e9-8364-b8dec7f44428.png)
-
-### Recall / Activate Scene
-**Any** passed in value on the scene node activates the preconfigured scene. Please note that recalling animated scenes may not work properly due to some restrictions.
-
-### Apply scenes dynamically
-When no scene is configured a scene name or scene Id must be passed in to activate that scene. It is also possible to pass a group Id dynamically to recall a scene on a specific group only. The following parameters can be passed manually in **msg.payload**.
-
-|  Property |  Type  |                     Information                    |
-|:---------:|:------:|:--------------------------------------------------:|
-| **scene** | string | Will activate the scene given by its name or id.   |
-| **group** | int    | Will recall a scene on a specific group by its id. |
-
-### Scene Events
-The event message that the scene node sends contains the following data in the **msg.payload** object. Events will only be sent if a scene receives any command.
-
-|     Property    |     Type    |                            Information                           |
-|:---------------:|:-----------:|:----------------------------------------------------------------:|
-| **id**          | string      | The unique scene id                                              |
-| **name**        | string      | The scene name                                                   |
-| **lightIds**    | array[int…] | Array of associated light ids in the scene                       |
-| **owner**       | string      | User who created the scene                                       |
-| **appData**     | object      | Object consisting of appData.version and appData.data properties |
-| **lastUpdated** | string      | ISO 8601 date string when scene was last updated                 |
-| **version**     | float       | Version number of the scene                                      |
-
-## Hue Tap
-Use the Hue Tap node to receive button events.
-
-![Hue Tap Example](https://user-images.githubusercontent.com/5302050/62820493-48dc5100-bb65-11e9-8932-e9f152b3c048.png)
-
-### Button Events
-The event message that the Hue Tap device sends contains the following data in the **msg.payload** object. Events will only sent on deploy (once) and if a button is pressed.
-
-|    Property   |  Type  |                          Information                         |
-|:-------------:|:------:|:------------------------------------------------------------:|
-| **button**    | int    | Pressed button number from 1-4                               |
-| **buttonAlt** | int    | Alternative pressed button number (unparsed from the bridge) |
-| **updated**   | string | ISO 8601 date string of the last button event                |
-
-### Additional Hue Tap Information
-The event message that the Hue Tap device sends also contains the following data in the **msg.info** object.
-
-|   Property   |  Type  |                                                             Information                                                             |
-|:------------:|:------:|:-----------------------------------------------------------------------------------------------------------------------------------:|
-| **id**       | int    | Numerical id of the sensor as registered on the bridge                                                                              |
-| **uniqueId** | string | Unique Id of the sensor (typically hardware id)                                                                                     |
-| **name**     | string | Name for the sensor                                                                                                                 |
-| **type**     | string | Sensor type (e.g. Daylight, CLIPTemperature, ZGPSwitch)                                                                             |
-| **model**    | object | The model object of the sensor includes model specific information like the model.id, model.manufacturer, model.name and model.type |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
-
-## Hue Switch
-Use the Hue Switch node to receive button events.
-
-![Hue Switch Example](https://user-images.githubusercontent.com/5302050/62820494-48dc5100-bb65-11e9-82eb-0c8bc9e5be40.png)
-
-### Button Events
-The event message that the Hue Wireless Dimmer Switch sends contains the following data in the **msg.payload** object. Events will only sent on deploy (once) and if a button is pressed.
-
-|   Property  |  Type  |                                                              Information                                                              |
-|:-----------:|:------:|:-------------------------------------------------------------------------------------------------------------------------------------:|
-| **button**  | int    | Pressed button id ([more information under 1.2 ZLL Switch](https://developers.meethue.com/documentation/supported-sensors#zgpSwitch)) |
-| **name**    | string | Human readable pressed button name *(On, Dim Up, Dim Down, Off)*                                                                      |
-| **action**  | string | Human readable pressed button action *(pressed, holded, short released, long released)*                                               |
-| **updated** | string | ISO 8601 date string of the last button event                                                                                         |
-
-### Additional Hue Switch Information
-The event message that the Hue Wireless Dimmer Switch device sends also contains the following data in the **msg.info** object.
-
-|   Property   |  Type  |                                                             Information                                                             |
-|:------------:|:------:|:-----------------------------------------------------------------------------------------------------------------------------------:|
-| **id**       | int    | Numerical id of the sensor as registered on the bridge                                                                              |
-| **uniqueId** | string | Unique Id of the sensor (typically hardware id)                                                                                     |
-| **name**     | string | Name for the sensor                                                                                                                 |
-| **type**     | string | Sensor type (e.g. Daylight, CLIPTemperature, ZGPSwitch)                                                                             |
-| **battery**  | int    | Current battery level of the Hue Switch in percent                                                                                  |
-| **model**    | object | The model object of the sensor includes model specific information like the model.id, model.manufacturer, model.name and model.type |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
-
-## Hue Button
-Use the Hue Button node to receive button events.
-
-![Hue Button Example](https://user-images.githubusercontent.com/5302050/90398480-cbadbb00-e099-11ea-8406-a48988c421bd.png)
-
-### Button Events
-The event message that the Hue Smart Button sends contains the following data in the **msg.payload** object.
-
-|   Property  |  Type  |                                                              Information                                                              |
-|:-----------:|:------:|:-------------------------------------------------------------------------------------------------------------------------------------:|
-| **button**  | int    | Pressed button id, 1002 for normal press, 1003 for long press (release) and 1001 during long press. 								   |
-| **name**    | string | Human readable pressed button name *(always On)*                                           			                               |
-| **action**  | string | Human readable pressed button action *(short released, long released, holded)*                         		                       |
-| **updated** | string | ISO 8601 date string of the last button event                                                                                         |
-
-### Additional Hue Button Information
-The event message that the Hue Button device sends also contains the following data in the **msg.info** object.
-
-|   Property   |  Type  |                                                             Information                                                             |
-|:------------:|:------:|:-----------------------------------------------------------------------------------------------------------------------------------:|
-| **id**       | int    | Numerical id of the sensor as registered on the bridge                                                                              |
-| **uniqueId** | string | Unique Id of the sensor (typically hardware id)                                                                                     |
-| **name**     | string | Name for the sensor                                                                                                                 |
-| **type**     | string | Sensor type (e.g. Daylight, CLIPTemperature, ZGPSwitch)                                                                             |
-| **battery**  | int    | Current battery level of the Hue Switch in percent                                                                                  |
-| **model**    | object | The model object of the sensor includes model specific information like the model.id, model.manufacturer, model.name and model.type |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
-
-## Hue Motion Sensor
-Use the Hue Motion node to control the motion sensor and receive motion events.
-
-![Hue Motion Example](https://user-images.githubusercontent.com/5302050/62820498-48dc5100-bb65-11e9-8887-3e63317856aa.png)
-
-### Activate / Deactivate Sensor
-Activates or deactivates the motion sensor based on the passed in **msg** values of:
-
-|   Property  |   Type  |                              Information                                 |
-|:-----------:|:-------:|:------------------------------------------------------------------------:|
-| **payload** | boolean | True to activate the motion sensor, false to deactivate                  |
-| **status**  |   any   | Returns the current status message of the node without taking any action |
-
-### Motion Events
-The event message that the motion sensor sends contains the following data in the **msg.payload** object. Events will only be sent if a motion is detected, if a motion stops or if the motion sensor receives the *Activate / Deactivate* command.
-
-|   Property  |   Type  |                    Information                   |
-|:-----------:|:-------:|:------------------------------------------------:|
-| **active**  | boolean | Current sensor state                             |
-| **motion**  | boolean | Indicates if a motion is detected or not         |
-| **updated** | string  | ISO 8601 date string of the last detected motion |
-
-### Additional Motion Sensor Information
-The event message that the motion sensor sends also contains the following data in the **msg.info** object.
-
-|       Property      |  Type  |                                                             Information                                                             |
-|:-------------------:|:------:|:-----------------------------------------------------------------------------------------------------------------------------------:|
-| **id**              | int    | Numerical id of the sensor as registered on the bridge                                                                              |
-| **uniqueId**        | string | Unique Id of the sensor (typically hardware id)                                                                                     |
-| **name**            | string | Name for the sensor                                                                                                                 |
-| **type**            | string | Sensor type (e.g. Daylight, CLIPTemperature, ZGPSwitch)                                                                             |
-| **softwareVersion** | float  | Software version of the sensor                                                                                                      |
-| **battery**         | int    | Current battery level of the temperature sensor in percent                                                                          |
-| **model**           | object | The model object of the sensor includes model specific information like the model.id, model.manufacturer, model.name and model.type |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
-
-## Hue Temperature Sensor
-Use the Hue Temperature node to receive current (room) temperature in Celsius and Fahrenheit.
-
-![Hue Temperature Example](https://user-images.githubusercontent.com/5302050/62820492-4843ba80-bb65-11e9-8a73-0e0764888595.png)
-
-### Temperature Events
-The event message that the temperature sensor sends contains the following data in the **msg.payload** object. Events will only sent on deploy (once) and if the temperature changes.
-
-|     Property    |  Type  |                     Information                     |
-|:---------------:|:------:|:---------------------------------------------------:|
-| **celsius**     | float  | Temperature in Celsius                              |
-| **fahrenheit**  | float  | Temperature in Fahrenheit                           |
-| **deviceValue** | int    | Temperature value of the sensor (original value)    |
-| **updated**     | string | ISO 8601 date string of the last temperature change |
-
-### Additional Temperature Sensor Information
-The event message that the temperature sensor sends also contains the following data in the **msg.info** object.
-
-|       Property      |  Type  |                                                             Information                                                             |
-|:-------------------:|:------:|:-----------------------------------------------------------------------------------------------------------------------------------:|
-|        **id**       |   int  | Numerical id of the sensor as registered on the bridge                                                                              |
-|     **uniqueId**    | string | Unique Id of the sensor (typically hardware id)                                                                                     |
-|       **name**      | string | Name for the sensor                                                                                                                 |
-|       **type**      | string | Sensor type (e.g. Daylight, CLIPTemperature, ZGPSwitch)                                                                             |
-| **softwareVersion** |  float | Software version of the sensor                                                                                                      |
-|     **battery**     |   int  | Current battery level of the temperature sensor in percent                                                                          |
-|      **model**      | object | The model object of the sensor includes model specific information like the model.id, model.manufacturer, model.name and model.type |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
-
-## Hue Lux Sensor
-Use the Hue Brightness node to receive the current light level in Lux and daylight / darkness.
-
-![Hue Lux Example](https://user-images.githubusercontent.com/5302050/62820501-4974e780-bb65-11e9-8b6b-5b9287efc74b.png)
-
-### Light Level Events
-The event message that the light sensor sends contains the following data in the **msg.payload** object. Events will only be sent on deploy (once) and if the light level changes.
-
-|    Property    |   Type  |                     Information                     |
-|:--------------:|:-------:|:---------------------------------------------------:|
-| **lux**        | int     | Real lux value                                      |
-| **lightlevel** | int     | Light level                                         |
-| **dark**       | boolean | True if it's dark                                   |
-| **daylight**   | boolean | True if daylight recognized                         |
-| **updated**    | string  | ISO 8601 date string of the last light level update |
-
-### Additional Lux Sensor Information
-The event message that the lux sensor sends also contains the following data in the **msg.info** object.
-
-|       Property      |  Type  |                                                             Information                                                             |
-|:-------------------:|:------:|:-----------------------------------------------------------------------------------------------------------------------------------:|
-|        **id**       |   int  | Numerical id of the sensor as registered on the bridge                                                                              |
-|     **uniqueId**    | string | Unique Id of the sensor (typically hardware id)                                                                                     |
-|       **name**      | string | Name for the sensor                                                                                                                 |
-|       **type**      | string | Sensor type (e.g. Daylight, CLIPTemperature, ZGPSwitch)                                                                             |
-| **softwareVersion** |  float | Software version of the sensor                                                                                                      |
-|     **battery**     |   int  | Current battery level of the temperature sensor in percent                                                                          |
-|      **model**      | object | The model object of the sensor includes model specific information like the model.id, model.manufacturer, model.name and model.type |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
-
-## Hue Rules
-Hue rule node to receive rule events or to enable / disable rules.
-
-![Hue Rules Example](https://user-images.githubusercontent.com/5302050/62820496-48dc5100-bb65-11e9-932d-6b0a46647e6a.png)
-
-### Enable / Disable Rule
-Activates or deactivates the rule based on the passed in **msg** values of:
-
-|   Property  |   Type  |                       Information                       |
-|:-----------:|:-------:|:-------------------------------------------------------:|
-| **payload** | boolean | True to enable the rule, false to disable 			  |
-
-### Trigger events
-The event message that the rule node sends contains the following data in the **msg.payload** object.
-
-|    Property   |  Type  |                        Information                       |
-|:-------------:|:------:|:--------------------------------------------------------:|
-| **triggered** | string | ISO 8601 date string of the last time rule was triggered |
-
-### Additional Rule Info
-Additional information about the rule is going to be sent to the **msg.info** object.
-
-|      Property      |  Type  |                      Information                      |
-|:------------------:|:------:|:-----------------------------------------------------:|
-|       **id**       |   int  | Numerical id of the rule as registered on the bridge  |
-|     **created**    | string | ISO 8601 date string of the creation date of the rule |
-|      **name**      | string | Name of the rule                                      |
-| **timesTriggered** |   int  | Number of times rule was triggered                    |
-|      **owner**     | string | User who created the rule                             |
-|     **status**     | string | enabled or disabled, rule is triggerable on enabled   |
-
-### Rule Conditions
-An array of objects representing the rule conditions is going to be sent to the **msg.conditions** array.
 
-|   Property   |  Type  |                      Information                     |
-|:------------:|:------:|:----------------------------------------------------:|
-|  **address** | string | The sensor resource/state location for the condition |
-| **operator** | string | The operator for the condition                       |
-|   **value**  | string | The value used in conjunction with operator          |
-
-### Rule Actions
-An array of objects representing the rule actions is going to be sent to **msg.actions** array.
-
-|   Property  |  Type  |                  Information                  |
-|:-----------:|:------:|:---------------------------------------------:|
-| **address** | string | The actionable resource location              |
-|  **method** | string | Type of method for the action (e.g. GET, PUT) |
-|   **body**  | object | The body of the action                        |
-
-### Last State Information
-This node also sends the entire last state data (before the update) in the **msg.lastState** object. It can either contain false (boolean) or the objects payload (msg.lastState.payload) and info (msg.lastState.info). The return value "false" is only sent if there was no last state, e.g. when the node was newly created or restarted.
+Sometimes it makes sense to play an animation in a disorderly manner - e.g. if fire should be imitated more realistically. To play the individual steps randomly, you can pass the following command to `msg.payload.specials`:
 
-# Changelog
+|Property|Description|
+|--|--|
+| randomOrder (boolean / any) | `true`, activates the random playback of the individual animation steps |
 
-### v2.8.6 (latest)
-* Optimized random color mode for Hue Magic, Hue Light & Hue Group nodes ([#190](https://github.com/Foddy/node-red-contrib-huemagic/pull/190))
-* New Hue Button node ([#190](https://github.com/Foddy/node-red-contrib-huemagic/pull/191))
-* Updated README and Hue Button node docs (+ localized in German)
+### Tips and hints
 
-### v2.8.2
-* Fixed an issue with Hue Light & Hue Group nodes on extended mode ([#179](https://github.com/Foddy/node-red-contrib-huemagic/issues/179))
-* Dependency updates
+This node does not output any status messages. Please connect the output of the node with a group instead of individual lights if you want to animate several lights at the same time with the same animation. The previews of the pre-made animations are simulations and may differ slightly (timing, colors) from the actual animation on a resource.
 
-### v2.8.1
-* Improved the speed of "future states" in Hue Group & Hue Light nodes
+## Hue Light
+The "Hue Light" node can control lights connected to the bridge and receive their status messages.
 
-### v2.8.0
-* Hue Light & Hue Group nodes can now receive commands even if the devices are off ([#110](https://github.com/Foddy/node-red-contrib-huemagic/issues/110) & [#155](https://github.com/Foddy/node-red-contrib-huemagic/issues/155))
-* Hue Light nodes now set their status to switched off when they are not reachable ([#170](https://github.com/Foddy/node-red-contrib-huemagic/issues/170))
+![Hue Light Example](https://user-images.githubusercontent.com/5302050/148696507-bea62f97-e9ec-496a-b7a2-8bf1942a3192.png)
 
-### v2.7.2
-* Fixed an issue with Hue Group nodes ([#178](https://github.com/Foddy/node-red-contrib-huemagic/issues/178))
+### Node-RED Setup Instructions
 
-### v2.7.1
-* Fixed a problem with "0" as topic in Hue Group nodes ([#166](https://github.com/Foddy/node-red-contrib-huemagic/issues/166))
-* Fixed an issue with the active property on Hue Motion nodes ([#172](https://github.com/Foddy/node-red-contrib-huemagic/issues/172))
-* Fixed a problem with "random" as a color command on Hue Group & Light nodes ([#167](https://github.com/Foddy/node-red-contrib-huemagic/issues/167))
-* Dependency & readme updates
+Select the pre-configured Hue Bridge and hit the search button to find all the available lights. If you already know the ID of a light, you can also enter it here manually. You can either assign a new name for the light internally or choose the predefined name. Optionally, you can also deactivate all automatic status messages for this node by clicking the setting "Skip events from node". The node will then no longer issue device updates. Alternatively, you can also choose whether the node's initialization message should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message for the currently selected light after each deployment.
 
-### v2.7.0
-* Fixed an error on Hue Scene nodes ([#164](https://github.com/Foddy/node-red-contrib-huemagic/issues/164))
-* New "lastState" property on every node (except Hue Magic & Hue Scene) with the last state before the update
+If you activate the setting "Activate color naming", the node will try to describe the currently set light color for each status message. You will then receive an additional parameter with the English description of the currently set color in the output.
 
-### v2.6.5
-* Fixed an error on Hue Group & Hue Light nodes ([#161](https://github.com/Foddy/node-red-contrib-huemagic/issues/161))
-* The colorloop effect in Hue Group & Hue Light nodes can now be activated and deactivated manually ([#158](https://github.com/Foddy/node-red-contrib-huemagic/pull/158))
-* New status property for Hue Light, Hue Group & Hue Motion nodes to request the current status of the devices ([#154](https://github.com/Foddy/node-red-contrib-huemagic/issues/154) & [#156](https://github.com/Foddy/node-red-contrib-huemagic/issues/156))
-* Dependency updates
+If you do not select a light and use the node configuration in this way, the node works in the so-called "universal mode". In this mode, the node receives and outputs all status messages of the same type. You can also apply settings in universal mode to a specific light by transferring the corresponding light ID as a string in `msg.topic` together with your settings.
 
-### v2.6.2
-* New original temperature parameter on Hue Temperature nodes
-* Nodes are now sending their status once after passing an action ([#150](https://github.com/Foddy/node-red-contrib-huemagic/issues/150) & [#153](https://github.com/Foddy/node-red-contrib-huemagic/issues/153))
-* Fixed an issue on the Hue Motion node ([#145](https://github.com/Foddy/node-red-contrib-huemagic/issues/145))
-* Dependency updates
+### Get status
 
-### v2.6.1
-* New option "incrementColorTemp" and "decrementBrightness" for Hue Light & Hue Group nodes ([#142](https://github.com/Foddy/node-red-contrib-huemagic/pull/142) / [#141](https://github.com/Foddy/node-red-contrib-huemagic/issues/141))
-* Fixed an issue on the Hue Scene node ([#139](https://github.com/Foddy/node-red-contrib-huemagic/issues/139))
-* Fixed an issue on the Hue Switch node ([#138](https://github.com/Foddy/node-red-contrib-huemagic/issues/138))
-* Removed brightness layer on Hue Magic animation previews due to performance issues
-
-### v2.6.0
-* Hue Bridge node can now fetch "Portal" and "Internet Services" information
-* Global device updates are now also pushed to the Hue Bridge node (check docs under "Global update events")
-* Removed software update logs on the Bridge (#93)
-* Message structures from each node are now outsourced
-
-### v2.5.5
-* Full German help docs translation of every node
-* Delay between bridge requests has been reduced to 500ms from 700ms
-* New "Strobo", "Random Rainbow" & "SOS" animations for the Hue Magic node
-* Hue Magic previews now also display brightness animations
-* Dependency updates
+Outputs the current status of the light as soon as a `msg.payload` object with the following content has been passed to the node. Alternatively, you can also press the button in the Node-RED interface without having to pass a message to the node beforehand.
 
-### v2.5.4
-* New option "brightnessLevel" for Hue Light & Hue Group nodes (#134)
-* Fixed an error on Hue Group & Hue Light nodes (#135)
-* Fixed an error on Hue Magic node and Hue Magic examples (#136)
-
-### v2.5.2
-* Fixed an error with the brightness and transitionTime params on Hue Light & Hue Group nodes (#131)
-* New option "ignoreOffLights" for Hue Group nodes to ignore state changes on turned off lights (#128)
-
-### v2.5.1
-* HueMagic nodes are now available in German
-* All HueMagic nodes are now compatible with the new Node-RED "complete" & "catch" nodes (Node-RED v1.0+)
-* Hue Bridge fetch actions now also send out an "info" object with further bridge information
-* New Hue Bridge sample flow can be imported directly from Node-RED
-* Fixed an issue with light & group nodes (#122)
-* Code optimizations and clean up
-
-### v2.2.6
-* Hue scenes can now be applied on specific groups
-* Hue Group nodes now support the option to select all groups / lights
-* Optimized Hue Magic node to load dependencies locally
-
-### v2.2.3
-* API requests are called again via the absolute path
-
-### v2.2.2
-* New "Hue Magic" node with 12 animations included (check docs and examples)
-* Sample flows for each node are now available and can be imported directly from Node-RED
-* Fixed an issue which prevented output events on the nodes (#116)
-
-### v2.1.1
-* Fixed an issue with the new option "skip events" on each node
-
-### v2.1.0
-* Node updates can now be deactivated individually or globally (check node settings or Hue Bridge configuration)
-* The "pressButton" option has been removed due to API restrictions on newer Hue Bridge firmwares (1.31+)
-
-### v2.0.5
-* A delay has been added to minimize API limit problems to the Hue Bridge
-* The color parameter now supports random colors via "any" or "random" as input (Hue Light & Group nodes)
-
-### v2.0.4
-* Support of the Hue Smart plug (BETA)
-* Support of alternative dimmer switches (check node docs, new property available)
-* Fixed a problem in recheck loop ([#96](https://github.com/Foddy/node-red-contrib-huemagic/issues/96#issuecomment-530469447))
-* Dependency updates
+|Property|Description|
+|--|--|
+| status (boolean) | Returns the current status of the light |
 
-### v2.0.2
-* New "Hue Rule" node (check node docs)
-* New "fetch" command for the Hue Bridge node to get various information
-* New "toggle" and "image" command for Hue Light and Group nodes
-* Transitions and colorloop effects now support millisecond values (comma values)
-* Optimized sequential requests to the bridge to avoid API limit errors
-* Fixed validation errors when group or light nodes are used in universal mode
-* Fixed a problem with human readable color names ([e354c0b](https://github.com/Foddy/node-red-contrib-huemagic/pull/84/commits/e354c0b3596d169fb25bd1e830df39adaf04dc73))
-* Updated readme
-* Dependency updates
+### Turn light on / off (simple)
 
-### v1.9.0
-* New "Hue Bridge" node (check node docs)
-* New event-based algorithm improves the stability of all nodes
-* New option to specify your own, alternative Hue Bridge port has been added (check node docs)
-* Fixed Hue Bridge API limit errors for bridges with a large number of devices
-* Other improvements
-* Dependency updates
+To quickly switch a light on or off in simple mode, pass an object with the following content to the node:
 
-### v1.5.6
-* New increment/decrement brightness setting in Hue Light and Hue Group nodes ([3a6977a](https://github.com/Foddy/node-red-contrib-huemagic/pull/54/commits/3a6977a1f8090917556f6ee4bdf4142fad7f7d85))
-* New real lux property to Hue Brightness event outputs ([thanks @Travelbacon](https://github.com/Foddy/node-red-contrib-huemagic/issues/49))
-* Added colorTemp property to Hue Light event outputs ([f8d237d](https://github.com/Foddy/node-red-contrib-huemagic/pull/52/commits/f8d237d6edf6772dbb73d9bd408e81a4ad4bd99a))
-* Manipulation of the update interval setting to avoid API errors with many devices
-* Fixed some annoying typos
-* Dependency updates
+|Property|Description|
+|--|--|
+| payload (boolean) | `true` switches the light on, `false` switches it off |
 
-### v1.5.4
-* Dependency updates
+### Light commands (extended)
 
-### v1.5.3
-* Fixed a typo in Hue Temperature node
-
-### v1.5.2
-* Added option to disable color naming in Hue Light & Hue Group config
-* Fixed hex color conversion for Hue Light and Hue Group nodes
-* More accurate color handling for light bulbs
-* Added reachable attribute to Hue Light node
-* Hue Tap can now send the same button action twice
-* Fixed Hue Brightness event trigger when lux is 0
-* UTC formatted "updated" date for Hue Brightness node
-* Better error handling for all nodes
-* Dependency updates
+In addition to simply switching it on and off, there are also many other options available for controlling the light. All nodes in HueMagic can be controlled with additive commands. This means that you can first pass one setting and then another setting in a later command without discarding the previous setting. Transfer the following parameters to a `msg.payload` object to make more extensive settings on the light:
 
-### v1.4.1
-* New color name setting in Hue Light and Hue Group nodes (check docs)
-* Human readable color names for Hue Lights and Hue Groups
-* HueMagic nodes are now all under the new "HueMagic" category in the palette
-* Support of Philips Hue API version v1.19.0+ and Node.js 8+
-* Dependency updates
+|Property|Description|
+|--|--|
+| on (boolean) | `true` switches the light on, `false` switches it off |
+| toggle (boolean / any) | Toggles between switching on and off, depending on the previous status of the light |
+| brightness (int / string) | Percentage value of the light brightness (0-100) or a string with the value `auto` to automatically set the brightness based on the current time |
+| brightnessLevel (int) | Numerical value of the light brightness (0-254) |
+| incrementBrightness (int / boolean) | Specifies by how many percent the light should be made brighter or `true` to make the light brighter in 10% steps |
+| decrementBrightness (int / boolean) | Specifies the percentage by which the light should be made darker or `true` to make the light darker in 10% steps |
+| color (string) | `random` to set a random color or an English color name (e.g. `red`) |
+| hex (string) | Color value in hexadecimal in the form of a string |
+| rgb (array [0,0,0]) | Color value in RGB format in the form of an array |
+| xyColor (object {x [float], y [float]}) | Color value in the XY color format in the form of an object |
+| gradient (object {hex […]}) | An object with a supported color object (e.g. `hex`,` rgb`, ...) and several colors to set a gradient to supported lights |
+| mixColor (object) | A color to be mixed with the current light color. Can accept `color`, `hex`, `rgb` or `xyColor` objects and optionally `amount` (int) to indicate the mixing ratio in percent |
+| image (string) | Path of an image (local or on the web) to set the current color of the light to the average color of the image |
+| saturation (int) | percentage of the saturation of the current color (beta) |
+| colorTemp (int / string) | Value between 153 and 500 to set the color temperature of the light or the values `cold`, `normal`, `warm`, `hot` and `auto` - where `auto` is the color temperature based on the current time |
+| incrementColorTemp (int / boolean) | Value by how much the color temperature should be warmer or `true` to make the color temperature warmer in steps of 50 |
+| decrementColorTemp (int / boolean) | Value by how much the color temperature should be colder or `true` to make the color temperature colder in steps of 50 |
+| transitionTime (float) | Transition time of the current setting in seconds. If `0` is entered, the light changes to the desired setting immediately. If `3` is entered, the light changes to the desired setting with a slight transition in the next 3 seconds |
+| colorloop (float) | Plays a "colorloop" animation for the selected duration in seconds and then switches back to the original state of the light |
+| alert (float) | Plays an "alert" animation for the selected duration in seconds and then switches back to the original state of the light |
 
-### v1.3.4
-* Improved status messages for transition commands
-* Dependency updates
+### Status messages from the node
 
-### v1.3.2
-* Fixed incorrect msg.topic handlings
-* Small improvements
-
-### v1.3.1
-* New "saturation" setting in Hue Light and Hue Group nodes
-* Improved input algorithm for Hue Lights and Groups nodes
-* Added range validation for the "brightness" setting
-* Setting the brightness level to "0" percent now turns off the lamp / group
-* Fixed an error where nodes are losing their Id
-* Fixed an error with the Hue Switch / Hue Tap node
-* Typo corrections in README and several node's information
-
-### v1.2.3
-* Fixed an error on the Hue Switch and Hue Tap nodes
-* Fixed an error with the "Universal Mode" on several nodes
-
-### v1.2.1
-* Support of Hue Taps and Wireless Dimmer Switches *(new nodes available)*
-* Improved connection handling with automatic reconnection
-* New option to configure color temperature on lights and groups ([28277f4](https://github.com/Foddy/node-red-contrib-huemagic/commit/28277f49eeb58d59377a609eb75573d7816c11fd))
-* Dependency updates
+As soon as a change in the light settings has been detected (regardless of whether via Node-RED or externally), the following status message is returned by the node:
+
+#### Status object under `msg.payload`
+
+|Property|Description|
+|--|--|
+| on (boolean) | State of the light, where `true` stands for on and `false` for off |
+| brightness (int / boolean) | Current brightness in percent or `false`, if the light does not support a brightness setting |
+| brightnessLevel (int / boolean) | Current brightness from 0-254 or `false`, if the light does not support a brightness setting |
+| reachable (boolean / string) | `true` if the light is connected to the bridge, `unknown` if the connection status deviates |
+| connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`, `disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
+| rgb (array [int, int, int] / optional) | Current light color in the form of an RGB value, if the light can display colors |
+| hex (string / optional) | Current light color in the form of a hexadecimal value if the light can display colors |
+| xyColor (object {x [float], y [float]} / optional) | Current light color in the form of an XY value, if the light can display colors |
+| color (string / optional) | Current light name in English, if the light can display colors and the corresponding setting of the node has been activated |
+| gradient (object / optional) | Current gradient setting with all available color units in the form of an array, if the light supports gradient settings, where `colors` outputs the colors, `numColors` the number of set colors in the gradient and `totalColors` the maximum possible Number of colors the resource can support in the gradient |
+| colorTemp (int / boolean / optional) | Current color temperature of the light, if the light can display color temperatures and a color temperature has been set |
+| colorTempName (string / optional) | Current color temperature of the light in the form of a descriptive string with the values `cold`,`normal`, `warm` or `hot`, if the light can display color temperatures and a color temperature has been set. Otherwise `unknown` is output |
+| updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
+
+#### Information about the light under `msg.info`
+
+|Property|Description|
+|--|--|
+| id (string) | Indicates the new ID of the light |
+| idV1 (string / boolean) | Indicates the old ID of the light |
+| uniqueId (string) | The unique ID of the light |
+| deviceId (string) | The unique ID of the device |
+| name (string) | The currently set name of the light |
+| type (string) | The type of light (always `light`) |
+| softwareVersion (string) | The current firmware of the light |
+| model (object) | Contains the model information of the light under `id`, `manufacturer`, `name`, `type`, `certified`, `friendsOfHue`, `colorGamut` and `colorGamutType` |
+
+#### Status changes under `msg.updated`
+
+Lists individual parameters in the form of an object that have changed compared to the last state of the light. If no changes have been registered, this object is empty.
+
+#### Last status of the light under `msg.lastState`
+
+Contains the complete status object (see output values above) of the last status before the last change. If the last state of HueMagic has not yet been registered, it will output `false`.
+
+#### Last command under `msg.command` (optional)
+
+If the status of the node has changed via a certain command, the entire command that was executed is also output. Otherwise this object will not be output by the node.
+
+## Hue Group
+The "Hue Group" node can control several lights behind a group on the bridge at the same time.
+
+![Hue Group Example](https://user-images.githubusercontent.com/5302050/148696506-e5c52750-39e1-43bc-a749-056d7a8718fc.png)
+
+### Node-RED Setup Instructions
+
+Select the pre-configured Hue Bridge and hit the search button to find all available groups. If you already know the ID of a group, you can also enter it here manually. You can either assign a new name for the group internally or choose the predefined name. Optionally, you can also deactivate all automatic status messages for this node by clicking the setting "Skip events from node". The node will then no longer issue any updates. Alternatively, you can also choose whether the node's initialization message should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message for the currently selected group after each deployment.
+
+If you do not select a group and use the node configuration in this way, the node works in the so-called "universal mode". In this mode, the node receives and outputs all status messages of the same type. You can also apply settings in universal mode to a specific group by transferring the corresponding group ID as a string in `msg.topic` together with your settings.
+
+### Get status
+
+Outputs the current status of the group as soon as a `msg.payload` object with the following content has been passed to the node. Alternatively, you can also press the button in the Node-RED interface without having to pass a message to the node beforehand.
+
+|Property|Description|
+|--|--|
+| status (boolean) | Returns the current status of the group |
+
+### Turn on / off (simple)
+
+To quickly turn an entire group on or off in simple mode, pass an object with the following content to the node. Please note that the command will only be executed if the current status of the group does not match your desired status. This means that all lights have to be switched off before you can switch them on with the `true` command.
+
+|Property|Description|
+|--|--|
+| payload (boolean) | `true` switches the whole group on, `false` switches them off |
+
+### Group commands (extended)
+
+In addition to simply switching it on and off, there are also many other options available for controlling the group. All nodes in HueMagic can be controlled with additive commands. This means that you can first pass one setting and then another setting in a later command without discarding the previous setting. Transfer the following parameters to an `msg.payload` object to make more extensive settings for the group:
+
+|Property|Description|
+|--|--|
+| on (boolean) | `true` switches the entire group on, `false` switches it off (please note the note above) |
+| toggle (boolean / any) | Toggles between switching on and off, depending on the previous status of the group |
+| brightness (int / string) | Percentage value of the light brightness (0-100) or a string with the value `auto` to automatically set the light brightness based on the current time |
+| brightnessLevel (int) | Numerical value of the light brightness (0-254) |
+| color (string) | `random` to set a random color or an English color name (e.g. `red`) |
+| hex (string) | Color value in hexadecimal in the form of a string |
+| rgb (array [0,0,0]) | Color value in RGB format in the form of an array |
+| xyColor (object {x [float], y [float]}) | Color value in the XY color format in the form of an object |
+| image (string) | Path of an image (local or on the web) to set the current color of the group to the average color of the image |
+| colorTemp (int / string) | Value between 153 and 500 to set the color temperature of the group or the values `cold`, `normal`, `warm`, `hot` and `auto` - where `auto` is the color temperature based on the current time |
+| transitionTime (float) | Transition time of the current setting in seconds. If `0` is passed, the group changes to the desired setting immediately. If you pass it to `3`, the group changes to the desired setting with a slight transition in the next 3 seconds |
+| colorloop (float) | Plays a “colorloop” animation for the selected duration in seconds and then changes back to the group's original state |
+| alert (float) | Plays an "alert" animation for the selected duration in seconds and then switches back to the original status of the group |
+
+### Status messages from the node
+
+If a change in the group is detected, the following status message is returned from the node. Please note that the group only outputs status messages when either the last light is switched off or when the first light is switched on (if all were switched off beforehand).
+
+In contrast to the "Hue Light" node, you have much less status information available here, as a group can contain many different device types with different values that cannot be combined.
+
+#### Status object under `msg.payload`
+
+|Property|Description|
+|--|--|
+| on (boolean) | State of the group, where `true` stands for on and `false` for off |
+| updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
+
+#### Information about the group under `msg.info`
+
+|Property|Description|
+|--|--|
+| id (string) | Indicates the new ID of the group |
+| idV1 (string / boolean) | Indicates the old ID of the group |
+| name (string) | The currently set name of the group |
+| type (string) | The type of the group (always `group`) |
+
+#### Status changes under `msg.updated`
+
+Lists individual parameters in the form of an object that have changed compared to the last state of the group. If no changes have been registered, this object is empty.
+
+#### Last status of the light under `msg.lastState`
+
+Contains the complete status object (see output values above) of the last status before the last change. If the last state of HueMagic has not yet been registered, it will output `false`.
+
+#### Last command under `msg.command` (optional)
+
+If the status of the node has changed via a certain command, the entire command that was executed is also output. Otherwise this object will not be output by the node.
+
+## Hue Scene
+The "Hue Scene" node can resume scenes saved in the bridge and apply them to certain groups.
+
+![Hue Scene Example](https://user-images.githubusercontent.com/5302050/148696512-c9cf3800-935f-44b3-a5e6-8c5e70a71357.png)
+
+### Node-RED Setup Instructions
+
+Select the pre-configured Hue Bridge and hit the search button to find all the available scenes. If you already know the ID of the scene, you can also enter it here manually. Alternatively, you can also assign an internal name for the scene or choose the predefined name of the scene.
+
+### Activate scene
+
+You can activate a predefined scene by transferring an object with the following content:
+
+|Property|Description|
+|--|--|
+| payload (boolean) | Activates a preconfigured scene |
+
+### Activate scene in universal mode
+
+If you operate this node in the so-called "universal mode" and have not set a scene in the node configuration, you can also transfer your desired scene to the node as a command. To do this, pass a `msg.payload` object with the following content:
+
+|Property|Description|
+|--|--|
+| scene (string) | ID of the scene to be activated on the bridge |
+
+### Activate scene on certain groups
+
+Connect the output of this node to one or more groups to apply a scene to specific groups. Alternatively, you have the option of doing this "dynamically" by passing an `msg.payload` object with the following content to the node:
+
+|Property|Description|
+|--|--|
+| group (string / array [string,…]) | ID of the group or an array with the IDs of several groups in order to limit the scene to these groups |
+
+### More information about the Node
+
+This node does not issue any status messages. Please also note that you can only apply scenes to groups if these are already linked to the respective scene on the bridge. Otherwise nothing will be applied.
+
+## Hue Buttons
+The "Hue Buttons" node receives switching events from input devices connected to the bridge.
+
+![Hue Buttons Example](https://user-images.githubusercontent.com/5302050/148696505-026a3eaf-b5a6-4438-ad71-57d62830799f.png)
+
+### Node-RED Setup Instructions
+
+Select the pre-configured Hue Bridge and hit the search button to find all the available switches/buttons. If you already know the ID of the switch, you can also enter it here manually. You can either assign a new name for the switch internally or keep the predefined name of the device. Optionally, you can also deactivate all automatic status messages for this node by clicking the setting "Skip events from node". The node will then no longer output any switching events. Alternatively, you can also choose whether the node's initialization message should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message for the currently selected switch after each deployment.
 
-### v1.1.9
-* Improved alert function with configurable amount of seconds
-* Several fixes and optimizations
+If you do not select a switch/button and use the node configuration in this way, the node works in the so-called "universal mode". In this mode, the node receives and outputs all status messages of the same type.
 
-### v1.1.8
-* New "universal mode" for Hue Light and Hue Group nodes
+### Get status
 
-### v1.1.7
-* Replacing "superagent" dependency with "request" due to security vulnerabilities
-* Several small fixes and optimizations for hue bridge node
+Outputs the current status of the switch/button as soon as a `msg.payload` object with the following content has been passed to the node. Alternatively, you can also press the button in the Node-RED interface without having to pass a message to the node beforehand.
 
-### v1.1.3
-* Several fixes for the Hue Light and Hue Group nodes
+|Property|Description|
+|--|--|
+| status (boolean) | Returns the current status of the switch/button |
 
-### v1.1.2
-* Fixed block-scoped declarations for Node.js below version 6.x
+### Status messages from the node
 
-### v1.1.0
-* Support of Hue Scenes (new scene node)!
-* Removed "id, "lightIds" and "battery" parameter in msg.payload of sensors / lights / groups
-* Added msg.info object on all node events with extended device information
+As soon as a key has been pressed, the following status message is returned by the node:
 
-### v1.0.3
-* Typo corrections and small improvements
+#### Status object under `msg.payload`
 
-### v1.0.0
-* Initial release
+|Property|Description|
+|--|--|
+| reachable (boolean / string) | `true` if the switch/button is connected to the bridge, `unknown` if the connection status deviates |
+| connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`, `disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
+| button (int / boolean) | Numeric ID of the key that was last pressed or `false` if no key was pressed |
+| action (string / boolean) | `false` if no key was pressed or `initial_press`, `repeat` , `short_release`, `long_release` or `double_short_release` in the form of a string |
+| updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
+
+#### Information about the switch/button under `msg.info`
+
+|Property|Description|
+|--|--|
+| id (string) | Indicates the new ID of the switch/button |
+| idV1 (string / boolean) | Indicates the old ID of the switch/button |
+| uniqueId (string) | The unique ID of the switch/button |
+| deviceId (string) | The unique ID of the device |
+| name (string) | The currently set name of the switch/button |
+| type (string) | The type of the switch/button (always `button`) |
+| softwareVersion (string) | The current firmware of the switch/button |
+| battery (float / boolean) | The current battery level of the switch/button, `false`, when there is no battery |
+| batteryState (string / boolean) | The current status of the battery level. Can contain `normal`, `low` or `critical` as a value, `false`, when there is no battery |
+| model (object) | Contains the model information of the switch/button under `id` , `manufacturer`, `name`, `type` and `certified` |
+
+#### Status changes under `msg.updated`
+
+Lists individual parameters in the form of an object that have changed compared to the last state of the switch/button. If no changes have been registered, this object is empty.
+
+#### Last status of the switch/button under `msg.lastState`
+
+Contains the complete status object (see output values above) of the last status before the last registered change. If the last state of HueMagic has not yet been registered, it will output `false`.
+
+#### Last command under `msg.command` (optional)
+
+If the status of the node has changed via a certain command, the entire command that was executed is also output. Otherwise this object will not be output by the node.
+
+## Hue Motion
+The "Hue motion" node can register and report movements from a suitable sensor on the bridge.
+
+![Hue Motion Example](https://user-images.githubusercontent.com/5302050/148696510-c6bfcad3-cd4e-4b6a-a73f-29bef1ac6961.png)
+
+### Node-RED Setup Instructions
+
+Select the pre-configured Hue Bridge and click the search button to find all the available sensors. If you already know the ID of the sensor, you can also enter it here manually. You can either assign a new name for the sensor internally or choose the predefined name of the sensor. Optionally, you can also deactivate all automatic status messages for this node by clicking the setting "Skip events from node". The node will then no longer issue device updates. Alternatively, you can also choose whether the node's initialization message should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message for the currently selected sensor after each deployment.
+
+If you do not select a sensor and use the node configuration in this way, the node works in the so-called "universal mode". In this mode, the node receives and outputs all status messages of the same type. You can also apply settings in universal mode to a specific sensor by transferring the corresponding sensor ID as a string in `msg.topic` together with your settings.
+
+### Get status
+
+Outputs the current status of the sensor as soon as a `msg.payload` object with the following content has been transferred to the node. Alternatively, you can also press the button in the Node-RED interface without having to pass a message to the node beforehand.
+
+|Property|Description|
+|--|--|
+| status (boolean) | Returns the current status of the sensor |
+
+### Turn the sensor on / off
+
+If necessary, the sensor can be turned on and off remotely. If the sensor has been turned off, it no longer registers any movements and accordingly no longer outputs them. To do this, pass an object with the following content:
+
+|Property|Description|
+|--|--|
+| payload (boolean) | `true` turns the sensor on,` false` turns it off |
+
+### Status messages from the node
+
+As soon as the sensor has registered a movement, the following status message is returned by the node:
+
+#### Status object under `msg.payload`
+
+|Property|Description|
+|--|--|
+| active (boolean) | Indicates whether the sensor is switched on or off |
+| reachable (boolean / string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
+| connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`, `disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
+| motion (boolean) | Indicates whether a motion has been registered |
+| updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
+
+#### Information about the sensor under `msg.info`
+
+|Property|Description|
+|--|--|
+| id (string) | Indicates the new ID of the sensor |
+| idV1 (string / boolean) | Indicates the old ID of the sensor |
+| uniqueId (string) | The unique ID of the sensor |
+| deviceId (string) | The unique ID of the device |
+| name (string) | The currently set name of the sensor |
+| type (string) | The type of the sensor (always `motion`) |
+| softwareVersion (string) | The current firmware of the sensor |
+| battery (float) | The current battery level of the sensor |
+| batteryState (string) | The current status of the battery level. Can contain `normal`, `low` or `critical` as a value |
+| model (object) | Contains the model information of the sensor under `id`, `manufacturer`, `name`, `type` and `certified` |
+
+#### Status changes under `msg.updated`
+
+Lists individual parameters in the form of an object that have changed compared to the last state of the sensor. If no changes have been registered, this object is empty.
+
+#### Last status of the sensor under `msg.lastState`
+
+Contains the complete status object (see output values above) of the last status before the last registered change. If the last state of HueMagic has not yet been registered, it will output `false`.
+
+#### Last command under `msg.command` (optional)
+
+If the status of the node has changed via a certain command, the entire command that was executed is also output. Otherwise this object will not be output by the node.
+
+## Hue Temperature
+The "Hue Temperature" node can call up and report the current ambient temperature from a suitable sensor on the bridge.
+
+![Hue Temperature Example](https://user-images.githubusercontent.com/5302050/148696513-0a3afec5-e85b-40fb-be77-1fbfdc1fad35.png)
+
+### Node-RED Setup Instructions
+
+Select the pre-configured Hue Bridge and click the search button to find all the available sensors. If you already know the ID of the sensor, you can also enter it here manually. You can either assign a new name for the sensor internally or choose the predefined name of the sensor. Optionally, you can also deactivate all automatic status messages for this node by clicking the setting "Skip events from node". The node will then no longer issue device updates. Alternatively, you can also choose whether the node's initialization message should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message for the currently selected sensor after each deployment.
+
+If you do not select a sensor and use the node configuration in this way, the node works in the so-called "universal mode". In this mode, the node receives and outputs all status messages of the same type. You can also apply settings in universal mode to a specific sensor by transferring the corresponding sensor ID as a string in `msg.topic` together with your settings.
+
+### Get status
+
+Outputs the current status of the sensor as soon as a `msg.payload` object with the following content has been transferred to the node. Alternatively, you can also press the button in the Node-RED interface without having to pass a message to the node beforehand.
+
+|Property|Description|
+|--|--|
+| status (boolean) | Returns the current status of the sensor |
+
+### Switch the sensor on / off
+
+If necessary, the sensor can be switched on and off remotely. If the sensor has been switched off, it no longer registers any temperature changes and accordingly no longer outputs them. To do this, pass an object with the following content:
+
+|Property|Description|
+|--|--|
+| payload (boolean) | `true` switches the sensor on, `false` switches it off |
+
+### Status messages from the node
+
+As soon as the sensor has registered a temperature change, the following status message is returned by the node:
+
+#### Status object under `msg.payload`
+
+|Property|Description|
+|--|--|
+| active (boolean) | Indicates whether the sensor is switched on or off |
+| reachable (boolean / string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
+| connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`, `disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
+| celsius (float) | Indicates the current ambient temperature in °C (degrees Celsius) |
+| fahrenheit (float) | Indicates the current ambient temperature in °F (degrees Fahrenheit) |
+| temperatureIs (string) | Describes the current temperature with the values ´very cold´, ´cold´, ´slightly cold´, ´comfortable´, ´slightly warm´, ´warm´, ´hot´ or ´very hot´ |
+| deviceValue (float) | The original value of the temperature from the sensor |
+| updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
+
+#### Information about the sensor under `msg.info`
+
+|Property|Description|
+|--|--|
+| id (string) | Indicates the new ID of the sensor |
+| idV1 (string / boolean) | Indicates the old ID of the sensor |
+| uniqueId (string) | The unique ID of the sensor |
+| deviceId (string) | The unique ID of the device |
+| name (string) | The currently set name of the sensor |
+| type (string) | The type of the sensor (always `temperature`) |
+| softwareVersion (string) | The current firmware of the sensor |
+| battery (float) | The current battery level of the sensor |
+| batteryState (string) | The current status of the battery level. Can contain `normal`, `low` or `critical` as a value |
+| model (object) | Contains the model information of the sensor under `id`, `manufacturer`, `name`, `type` and `certified` |
+
+#### Status changes under `msg.updated`
+
+Lists individual parameters in the form of an object that have changed compared to the last state of the sensor. If no changes have been registered, this object is empty.
+
+#### Last status of the sensor under `msg.lastState`
+
+Contains the complete status object (see output values above) of the last status before the last registered change. If the last state of HueMagic has not yet been registered, it will output `false`.
+
+#### Last command under `msg.command` (optional)
+
+If the status of the node has changed via a certain command, the entire command that was executed is also output. Otherwise this object will not be output by the node.
+
+## Hue Brightness
+The "Hue Brightness" node can read the current light level from a suitable sensor on the bridge.
+
+![Hue Brightness Example](https://user-images.githubusercontent.com/5302050/148696504-7d447ea8-bbe3-41e3-9a69-ac8e97ac8d90.png)
+
+### Node-RED Setup Instructions
+
+Select the pre-configured Hue Bridge and click the search button to find all the available sensors. If you already know the ID of the sensor, you can also enter it here manually. You can either assign a new name for the sensor internally or choose the predefined name of the sensor. Optionally, you can also deactivate all automatic status messages for this node by clicking the setting "Skip events from node". The node will then no longer issue device updates. Alternatively, you can also choose whether the node's initialization message should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message for the currently selected sensor after each deployment.
+
+If you do not select a sensor and use the node configuration in this way, the node works in the so-called "universal mode". In this mode, the node receives and outputs all status messages of the same type. You can also apply settings in universal mode to a specific sensor by transferring the corresponding sensor ID as a string in `msg.topic` together with your settings.
+
+### Get status
+
+Outputs the current status of the sensor as soon as a `msg.payload` object with the following content has been transferred to the node. Alternatively, you can also press the button in the Node-RED interface without having to pass a message to the node beforehand.
+
+|Property|Description|
+|--|--|
+| status (boolean) | Returns the current status of the sensor |
+
+### Turn the sensor on / off
+
+If necessary, the sensor can be turned on and off remotely. If the sensor has been turned off, it no longer registers any changes in light level and accordingly no longer outputs them. To do this, pass an object with the following content:
+
+|Property|Description|
+|--|--|
+| payload (boolean) | `true` switches the sensor on, `false` switches it off |
+
+### Status messages from the node
+
+As soon as the sensor has detected a change in the light level, the following status message is returned:
+
+#### Status object under `msg.payload`
+
+|Property|Description|
+|--|--|
+| active (boolean) | Indicates whether the sensor is turned on or off |
+| reachable (boolean / string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
+| connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`,` disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
+| lux (int) | Indicates the real LUX value of the light level |
+| lightLevel (int) | Indicates the light intensity of the sensor |
+| dark (boolean) | `true`, if darkness was registered |
+| daylight (boolean) | `true`, if daylight was registered |
+| updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
+
+#### Information about the sensor under `msg.info`
+
+|Property|Description|
+|--|--|
+| id (string) | Indicates the new ID of the sensor |
+| idV1 (string / boolean) | Indicates the old ID of the sensor |
+| uniqueId (string) | The unique ID of the sensor |
+| deviceId (string) | The unique ID of the device |
+| name (string) | The currently set name of the sensor |
+| type (string) | The type of the sensor (always `light_level`) |
+| softwareVersion (string) | The current firmware of the sensor |
+| battery (float) | The current battery level of the sensor |
+| batteryState (string) | The current status of the battery level. Can contain `normal`, `low` or `critical` as a value |
+| model (object) | Contains the model information of the sensor under `id`, `manufacturer`, `name`, `type` and `certified` |
+
+#### Status changes under `msg.updated`
+
+Lists individual parameters in the form of an object that have changed compared to the last state of the sensor. If no changes have been registered, this object is empty.
+
+#### Last status of the sensor under `msg.lastState`
+
+Contains the complete status object (see output values above) of the last status before the last registered change. If the last state of HueMagic has not yet been registered, it will output `false`.
+
+#### Last command under `msg.command` (optional)
+
+If the status of the node has changed via a certain command, the entire command that was executed is also output. Otherwise this object will not be output by the node.
+
+## Hue Rule
+The "Hue Rule" node can activate or deactivate rules saved in the bridge and call up their settings.
+
+![Hue Rule Example](https://user-images.githubusercontent.com/5302050/148696511-2bbd6940-2b38-40a0-a68a-ad52631add26.png)
+
+### Node-RED Setup Instructions
+
+Select the pre-configured Hue Bridge and hit the search button to find all the available rules. If you already know the ID of the rule, you can also enter it here manually. Alternatively, you can also assign a new name or choose the predefined name of the rule.
+
+If you do not select a rule and use the node configuration in this way, the node works in the so-called "universal mode". In this mode, the node receives and outputs all status messages of the same type. You can also apply settings in universal mode to a specific rule by transferring the corresponding rule ID as a string in `msg.topic` together with your settings.
+
+### Get properties / settings
+
+Outputs the current properties of the rule as soon as a `msg.payload` object with the following content has been passed to the node. Alternatively, you can also press the button in the Node-RED interface without having to pass a message to the node beforehand.
+
+|Property|Description|
+|--|--|
+| status (boolean) | Returns the current status of the rule |
+
+### Activate / deactivate rule
+
+The rule can be activated and deactivated if necessary. If the rule has been deactivated, it will no longer run in the bridge until you reactivate it. To do this, pass an object with the following content:
+
+|Property|Description|
+|--|--|
+| payload (boolean) | `true` activates the rule, `false` deactivates it |
+
+### Status messages from the node
+
+As soon as the status (activated / deactivated) of a rule changes, the following status message is returned by the node:
+
+#### Status object under `msg.payload`
+
+|Property|Description|
+|--|--|
+| enabled (boolean) | Indicates whether the rule is activated or deactivated |
+| triggered (string) | Time of the last execution (ISO 8601) |
+
+#### Information about the rule under `msg.info`
+
+|Property|Description|
+|--|--|
+| id (string) | The unique ID of the rule |
+| created (string) | Date of creation of the rule (ISO 8601) |
+| name (string) | Name of the rule on the bridge |
+| timesTriggered (int) | Number of times the rule was executed on the bridge |
+| owner (string) | ID of the owner of this rule |
+| status (string) | Status of the rule in the form of a string |
+
+#### Rule conditions under `msg.conditions` (array)
+
+|Property|Description|
+|--|--|
+| address (string) | Path to an attribute of a sensor |
+| operator (string) | operator |
+| value (string) | The value to be checked |
+
+#### Rule actions under `msg.actions` (array)
+
+|Property|Description|
+|--|--|
+| address (string) | The destination address of the resource |
+| method (string) | The query method |
+| body (object) | The action to be taken |
+
+#### Status changes under `msg.updated`
+
+Lists individual parameters in the form of an object that have changed compared to the last state of the rule. If no changes have been registered, this object is empty.
+
+#### Last status of the rule under `msg.lastState`
+
+Contains the complete object (see output values above) of the last status before the last registered change of the rule. If the last state of HueMagic has not yet been registered, it will output `false`.
+
+#### Last command under `msg.command` (optional)
+
+If the status of the node has changed via a certain command, the entire command that was executed is also output. Otherwise this object will not be output by the node.
+
+# Changelog
+
+### v4.0.2 (latest)
+
+> **Attention!** HueMagic v4 + has been almost completely rewritten under the hood and requires at least the (square-shaped) Philips Hue Bridge firmware 1948086000+ from November 1st, 2021 ([Upgrade instructions](https://www.lighting.philips.com/content/B2C/en_US/microsites/meethue/marketing-catalog/huewireless_ca/support/security-advisory/general/where-and-how-can-i-update-my-hue-system-with-the-latest-software.html)) and Node-RED v1+ ([Upgrade instructions](https://nodered.org/docs/getting-started/local#upgrading-node-red)). If you are upgrading from a previous HueMagic version to the v4, you will have to reconfigure (not completely rebuild) all nodes by clicking them and selecting the appropriate device from the list. This also applies to nodes / functions that are operated in universal mode, as the numeric identifiers of the latest Philips Hue API version have been replaced in UUIDs. The nodes "Hue Switch", "Hue Button" & "Hue Tap" have been replaced in v4 by the universal and uniform node "Hue Buttons", which works with all button / switch devices that are connected to the Hue Bridge (please note here also the new API in the documentation). The request and return objects of the individual nodes are largely compatible with older HueMagic versions - with the exception of the nodes "Hue Bridge", "Hue Buttons", "Hue Scene" & "Hue Group". These need to be adjusted in the v4. Make sure that you meet the minimum technical requirements and have a quiet minute for the migration before upgrading to the v4.
+
+* HueMagic speaks now directly with the bridge without any submodules *(huejay dependency removed)*
+* Migrated to the newest CLIP/v2 API version from the Philips Hue bridge
+* Nodes are now updated via push notifications (SSE) from the bridge instead of periodic polling
+* Instant "current status" queries on each node with no loading time
+* "Hue Buttons" node supports all new Philips Hue buttons/switches (e.g. Dimmer Switch v2, Hue Wall Switch…)
+* All nodes provide additional property information in the output (check docs)
+* New universal node "Hue Buttons" replaces the following nodes: "Hue Switch", "Hue Button", "Hue Tap"
+* New "updated" object for all nodes, which only contains the properties that have been updated since the last state
+* New configuration option to suppress first message after node initialization (for all nodes)
+* New gradient color setting for compatible light sources (in "Hue Light" node)
+* New inject button for almost all nodes, which triggers the current status of a node
+* New "universal mode" support for the "Hue Rule" node
+* New SVG-version of each node icon for higher quality rendering in the Node-RED UI
+* New and full featured examples for each node right inside Node-RED
+* New color mix feature in "Hue Light" nodes with the ability to mix the current light color with another
+* New automatic brightness support based on the current time for "Hue Light" & "Hue Group" nodes
+* New "Superhero", "Neon City" & "Christmas" (for next year, sorry) animations in "Hue Magic" node
+* The custom alert effect on "Hue Light" & "Hue Group" nodes can now also be configured in brightness
+* All nodes will now also forward the last command that has been applied ([#249](https://github.com/Foddy/node-red-contrib-huemagic/issues/249))
+* "Hue Temperature" & "Hue Brightness" nodes can now also be activated & deactivated
+* "Hue Light" & "Hue Group" nodes can now also receive XY color settings
+* "Hue Light" & "Hue Group" can now also receive a named color temperature setting
+* "Hue Light" & "Hue Group" nodes can now receive future brightness states in "turned off" mode ([#244](https://github.com/Foddy/node-red-contrib-huemagic/issues/244))
+* Automatic light temperature setting outputs now values from 153 (coldest) to 500 (warmest)
+* Automatic color correction based on the light´s capabilities for more accurate color settings
+* Optimized node editor configuration UI to better match the current Node-RED´s UI
+* The option for "automatic firmware updates" on the bridge moved to the bridge configuration node
+* "Hue Group" node does no longer contain the "msg.info.model" & "msg.info.class" property
+* Fixed timeout connection issues to the bridge
+* Fixed an issue with non stopping custom animations ([#222](https://github.com/Foddy/node-red-contrib-huemagic/issues/222)), ([#224](https://github.com/Foddy/node-red-contrib-huemagic/issues/224)) & ([#226](https://github.com/Foddy/node-red-contrib-huemagic/pull/226)) (thx)
+* Node-RED will no longer crash if there is no active connection to the bridge ([#237](https://github.com/Foddy/node-red-contrib-huemagic/issues/237))
+* Fixed an issue that prevented the light / group from not reporting its own status when queried & node events were deactivated ([#248](https://github.com/Foddy/node-red-contrib-huemagic/issues/248))
+* Fixed an issue with nodes in universal mode ([#245](https://github.com/Foddy/node-red-contrib-huemagic/issues/245))
+* A possible attack target has been fixed ([#217](https://github.com/Foddy/node-red-contrib-huemagic/issues/217))
+* Moved away from "moment.js" to "Day.js" for date/time formatting inside the nodes
+* Updated README and help section on each node
+* Updated dependencies to the latest version
+
+### v3.0.0
+* Hue Motion, Hue Brightness, Hue Tap, Hue Switch & Hue Button nodes can now receive a status request
+* New "Universal Mode" for the Hue Motion, Hue Brightness, Hue Tap, Hue Switch & Hue Button nodes
+* The "colorTemp" property for Hue Light & Hue Group nodes can now also be set to "cold", "normal", "warm" or "auto"
+* New dynamic and automatically calculated color temperature based on the current time ("auto" mode in "colorTemp" property)
+* Nodes in "Universal Mode" are now also able to receive all events from devices of its type (optional)
+* Hue Magic animations are now prerendered to improve performance
+* 3 new Hue Magic animations ("Milkyway", "Beach" & "Forest")
+* New (simple) Hue Button example flow
+* Updated docs for almost all nodes and README
+* Fixed an error with future states and the HTTP request node ([#200](https://github.com/Foddy/node-red-contrib-huemagic/pull/200))
+* Other optimizations, dependency updates and clean up
+
+### v2.8.6
+* Optimized random color mode for Hue Magic, Hue Light & Hue Group nodes ([#190](https://github.com/Foddy/node-red-contrib-huemagic/pull/190))
+* New Hue Button node ([#191](https://github.com/Foddy/node-red-contrib-huemagic/pull/191))
+* Updated README and Hue Button node docs (+ localized in German)
+
+### v2.8.2
+* Fixed an issue with Hue Light & Hue Group nodes on extended mode ([#179](https://github.com/Foddy/node-red-contrib-huemagic/issues/179))
+* Dependency updates
+
+### Previous versions
+A complete overview of the updates can be viewed in the [changelog](https://github.com/Foddy/node-red-contrib-huemagic/blob/master/CHANGELOG.md)…
 
 
 ***
-<a href="https://en.wikipedia.org/wiki/Stuttgart" target="_blank"><img src="https://gistcdn.githack.com/Foddy/0e2e2598e98ecdf3c9990dcf809c1752/raw/1807bc9d75aee1484be2f78678e14959497f764a/madewithlove.svg" height="50"></a>
+### Made with a pinch of magic in Stuttgart, Germany.
+
+If you like HueMagic, I appreciate a star or rating on this page! HueMagic is and will remain free. You can support the further development of the project with a small donation.
+
+Alternatively, you can support the project if you have an old device that is compatible with the Philips Hue bridge (or a device that is not officially supported by HueMagic) and want to get rid of it. Please contact me at huemagic@foddy.io to get an address where you can send your old device. The following devices could currently be considered: Gradient lights, Tap / Button devices or table / floor lights. These types of devices have not been extensively tested during HueMagic's development.
 
-Do you like HueMagic? If so, make sure to give this project a star! If you want to support the development, you can also do so with a donation. HueMagic remains completely free for everyone - even without a donation. Thank you! :)
 ***
 <a href="https://www.jetbrains.com/?from=HueMagic"><img src="https://gistcdn.githack.com/Foddy/062045775c28f5993ad646aba80e678c/raw/c84ea4ad31c72dde0883638fc9eaa2b51bba9962/jb.svg" height="50"></a> <a href="https://www.browserstack.com?from=HueMagic"><img src="https://gistcdn.githack.com/Foddy/062045775c28f5993ad646aba80e678c/raw/c84ea4ad31c72dde0883638fc9eaa2b51bba9962/browserstack.svg" height="50"></a>
 
 HueMagic for Node-RED is sponsored by [JetBrains](https://www.jetbrains.com/?from=HueMagic) and [BrowserStack](https://www.browserstack.com?from=HueMagic).<br>
-*Released under the [Apache License 2.0](https://tldrlegal.com/license/apache-license-2.0-(apache-2.0)).*
+*Released under the [Apache License 2.0](https://tldrlegal.com/license/apache-license-2.0-(apache-2.0)).*