Home Assistant Lighting Manager

Allows layers to be applied to lights. Useful for multiple levels of notifications and restoring states.

For example: If I want outdoor lights that are a dim white at night, I would add a scene at layer 0 (the lowest.) If something at night happens such as a home security system being triggered while I'm away, an automation would insert an alarm scene at a higher layer and be visible over the night time scene. Now if somehow the sun rises while the alarm scene is scening, to prevent an automation from turning the lights off, one would remove the night time scene from the bulbs' layers resulting in the alarm scene to still be active. When that scene is removed, the lights would look for the next lowest layer and turn off due to absence of a layer. Layers can endlessly be stacked and mixed to render smarter lighting scenes.

Configuration

Example configuration.yaml entry:

lighting_manager:
  entities:
    - light.porch_light_1
    - light.porch_light_2
    - light.foh_light_1
    - light.foh_light_2
    - light.foh_light_3

Services

lighting_manager.insert_scene

Apply a scene at a specified layer. All lights managed by lighting manager and in the specified scene will be updated with priority states. Any unmanaged lights and other entities will be updated as if scene.apply was called.

Service Parameters

Parameter	Description
entity_id	Entity ID of scene to be inserted.
layer_id	Layer ID. Used when removing or overriding layers.
priority	Layer priority. Higher values will appear before lower.

lighting_manager.insert_state

Apply lighting attributes to a light entity or group at a specified priority. If a light is specified and is not managed, nothing will happen. When a group is specified, any unmanaged lights within the group will be updated to reflect the new state.

Service Parameters

Parameter	Description
entity_id	Entity ID of light.
priority	Layer priority. Higher values will appear before lower.
id	Layer ID. Used when removing the state from layers.
attributes	A dictionary of light state attributes to be applied.

lighting_manager.remove_layer

Remove a layer by id from entity id of a light or group. If not entity id is specified, layer or scene will be removed from all managed lights.

Service Parameters

Parameter	Description
entity_id	Entity ID of light or group.
id	Layer ID to be removed.