mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-12-10 00:30:02 -06:00
0ea2127c91
Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com> Co-authored-by: Franck Nijhof <git@frenck.dev>
65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
---
|
|
title: Presence-based lights
|
|
description: Instructions on how to automate your lights with Home Assistant.
|
|
ha_category:
|
|
- Automation
|
|
- Light
|
|
- Presence detection
|
|
ha_iot_class: Calculated
|
|
ha_release: pre 0.7
|
|
ha_quality_scale: internal
|
|
ha_domain: device_sun_light_trigger
|
|
ha_integration_type: integration
|
|
related:
|
|
- docs: /docs/configuration/
|
|
title: 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](/integrations/sun/), [device_tracker](/integrations/device_tracker/), [person](/integrations/person/) and [light](/integrations/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 %}
|
|
|
|
```yaml
|
|
# 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:
|
|
|
|
```yaml
|
|
# 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
|
|
```
|