The light integration is how Home Assistant controls anything that lights up a room.
Spook adds actions for adjusting lights, rather than switching them: brightness, color, color temperature and effects. light.turn_on does two things at once: it sets a level and it turns the light on. Most of the time somebody adjusting a room means the first without the second, and there is no way to ask for that.
There is a second half to it. A light group is a light like any other, so asking one for a little more brightness has Home Assistant average its members, apply the step to that average, and then set every member to the result. A room with a lamp at 10% and one at 100% ends up with both at 65%: not brighter, just flatter. Spook’s actions work through to the members and step each from its own level.
Devices & entities¶
Spook does not provide any new devices or entities for this integration.
Actions¶
Spook adds the following new actions to your Home Assistant instance:
Set brightness¶
Set the brightness of the lights that are already on.
Action properties | |
|---|---|
Light: Set brightness 👻 | |
| |
Yes, | |
No response | |
Added action | |
Half brightness in the living room, without waking up whatever is off in there:
1 2 3 4 5 6action: light.set_brightness target: area_id: living_room data: brightness_pct: 50 transition: 2
Increase brightness¶
Turn up the lights that are already on.
Action properties | |
|---|---|
Light: Increase brightness 👻 | |
| |
Yes, | |
No response | |
Added action | |
A dim-up button that does what the one on a Hue remote does:
1 2 3 4 5action: light.increase_brightness target: entity_id: light.kitchen data: step_pct: 10
Decrease brightness¶
Turn down the lights that are already on, stopping at the dimmest they go.
Action properties | |
|---|---|
Light: Decrease brightness 👻 | |
| |
Yes, | |
No response | |
Added action | |
1 2 3 4 5action: light.decrease_brightness target: area_id: bedroom data: step_pct: 20
Set color¶
Set the color of the lights that are already on. Lights that cannot do color are passed over, rather than being turned white the way light.turn_on does to them.
Action properties | |
|---|---|
Light: Set color 👻 | |
| |
Yes, | |
No response | |
Added action | |
1 2 3 4 5action: light.set_color target: area_id: living_room data: rgb_color: [255, 127, 80]
Set color temperature¶
Set the color temperature of the lights that are already on, each within the range it can actually reach. Warm white on one lamp is a number another one cannot manage, and a room is rarely all the same model.
Action properties | |
|---|---|
Light: Set color temperature 👻 | |
| |
Yes, | |
No response | |
Added action | |
1 2 3 4 5 6action: light.set_color_temperature target: area_id: living_room data: kelvin: 2700 transition: 2
Set effect¶
Set an effect on the lights that are already on and actually have it. Effect names are per manufacturer and rarely agree, so a room is usually a mix of lights that know this one and lights that have never heard of it.
Action properties | |
|---|---|
Light: Set effect 👻 | |
| |
Yes, | |
No response | |
Added action | |
Action data parameters | |||
|---|---|---|---|
Attribute | Type | Required | Default / Example |
| Yes | Colorloop |
1 2 3 4 5action: light.set_effect target: entity_id: light.kitchen data: effect: Colorloop
Known limitations
Lights that are off are left alone. These actions adjust, they do not switch: turning the room up should not light up whatever somebody deliberately turned off.
Decreasing stops at the dimmest a light goes rather than switching it off, so holding a dim-down button leaves the room lit rather than dark.
A light that cannot do what is being asked is skipped rather than turned on regardless: an on-or-off light has no brightness to set, a white-only light has no color, and a light without a given effect has never heard of it.
Repairs¶
Spook has no repair detections for this integration.