# Random Lighting

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/logic/random-lighting/

_Requires Symcon >= 5.0_

The module allows to switch the color value of lamps randomly between different colors.

### function scope
- Color variables can be added to a list
- A list of colors can be selected from which can be expanded
- When the module is deactivated, the selected color variables are set to the value before activation
- Setting of the interval in which the colors should be changed

### software installation
- Using the [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) install the 'Random Lighting' module.

### Set up instances in IP-Symcon
- Under 'Add Instance' the 'Random Lighting' module can be found using the quick filter.
  - More information about adding instances in the [Instances documentation](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzuf%C3%BCgen)

#### Configuration Page:

| name                   | description                                                                   |
| ---------------------- | ----------------------------------------------------------------------------- |
| Color Variables        | List of color variables to be switched                                        |
| Colors                 | Colors from which one is randomly selected for switching                      |
| Change Interval        | Interval between each switching in seconds                                    |
| Simultaneous switching | defines if all color variables are set to the same color or to different ones |

### status variables
The status variables/categories are created automatically. Deleting individual ones can lead to malfunctions.

#### Status variables

| Name   | Type    | Description                   |
| ------ | ------- | ----------------------------- |
| Active | Boolean | Switches the module on or off |

## ZB_ChangeLight

Source: https://www.symcon.de/en/service/documentation/module-reference/logic/random-lighting/zb-changelight/

`bool ZB_ChangeLight(int $InstanceID)`

_Requires Symcon >= 5.0_

**Parameters**

- `$InstanceID` (int): ID of the Instance

**Returns** (bool): If the command could be executed successfully, it returns __TRUE__ as result, otherwise __FALSE__.

ID of the Instance

**Example**

```text
ZB_ChangeLight(12345);
```