home-assistant.io/source/_integrations/device_sun_light_trigger.markdown

title, description, ha_category, ha_iot_class, ha_release, ha_quality_scale, ha_domain, ha_integration_type, related

title	description	ha_category	ha_iot_class	ha_release	ha_quality_scale	ha_domain	ha_integration_type	related
Presence-based lights	Instructions on how to automate your lights with Home Assistant.	Automation Light Presence detection	Calculated	pre 0.7	internal	device_sun_light_trigger	integration	docs title /docs/configuration/ Configuration file

Home Assistant has a built-in {% term integration %} called device_sun_light_trigger to help you automate your lights. The integration will:

• Fade in the lights when the sun is setting and there are people home
• Turn on the lights when people get home after the sun has set
• Turn off the lights when all people leave the house

This integration requires the integrations sun, device_tracker, person and light to be enabled.

To enable this integration, add the following lines to your {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

# Example configuration.yaml entry
device_sun_light_trigger:

{% configuration %} light_group: description: Specify a specific light/group of lights that has to be turned on. required: false type: string light_profile: description: Specify which light profile to use when turning lights on. required: false default: relax type: string device_group: description: Specify which group to track. The group can contain device_trackers or persons. required: false type: string disable_turn_off: description: Disable lights being turned off when everybody leaves the house. required: false default: false type: boolean {% endconfiguration %}

A full configuration example could look like this:

# Example configuration.yaml entry
device_sun_light_trigger:
  light_group: group.living_room
  light_profile: relax
  device_group: group.my_devices
  disable_turn_off: true