Version: 2.8
The most common automation used for a sensor light.
The Automation Process:
- In this example we will use a Motion sensor as the trigger but you can use one or multiple Binary Sensors as the trigger/s.
- Triggers on a motion sensor and turns the lights ON.
- When no motion is detected, a time delay is activated and turns the lights OFF Automatically.
- The lights will stay ON if the motion sensor detects motion before the time delay turns the lights OFF. It will then reset the time delay after last motion is detected.
- You have the option to select scenes. This allows you to turn ON a scene when motion is detected and turn OFF a scene when the time delay has ended.
- You have the option to use the “Light Control”. This allows you to set a brightness level for your lights.
- You have the option to use the “Trigger Sensor By-pass”. This allows you to add a switch to manually By-pass the trigger sensor so you can use the lights as normal by turning them ON and OFF manually.
- You have the option to use the “Sun Elevation”. This is used for adding a condition to only work when it is dark by setting the suns position to the horizon.
- You have the option to set an Ambient Light Sensor and set the LUX value. This is used for adding a condition to only work when it is dark or below the Ambient Light LUX Value.
- You have the option to set a start time, an end time and select weekdays. This will only allow the automation to run between the time periods.
- You have the option to use the “Zone - Device Tracker”. This can be useful if you have pets triggering the trigger sensor turning your lights ON and OFF when no one is home.
- You have the option to use “Night Lights”. It is normally used for having lower softer lights come ON when going to the bathroom at night.
Need help? See our FAQ: Click Here
blueprint:
name: Sensor Light
description: >
# Sensor Light
**Version: 2.8**
The most common automation used for a sensor light. The good thing is, with this automation you can turn ON as many lights as you like by selecting an Area, a Device, an Entity or just any combination you like using just one sensor to do it. BE CAREFUL when selecting an Area or a Device as it will turn On and OFF everything attached, lights, switches, etc.
Let us know what you think of this blueprint and for community support including updates: [Click Here](https://community.home-assistant.io/t/sensor-light/481048)
**The Automation Process:**
- In this example we will use a Motion sensor as the trigger but you can use one or multiple [Binary Sensors](https://www.home-assistant.io/integrations/binary_sensor/) as the trigger/s.
- Triggers on a motion sensor and turns the lights ON.
- When no motion is detected, a time delay is activated and turns the lights OFF Automatically.
- The lights will stay ON if the motion sensor detects motion before the time delay turns the lights OFF. It will then reset the time delay after last motion is detected.
- You have the option to select scenes. This allows you to turn ON a scene when motion is detected and turn OFF a scene when the time delay has ended.
- You have the option to use the "Light Control". This allows you to set a brightness level for your lights.
- You have the option to use the "Trigger Sensor By-pass". This allows you to add a switch to manually By-pass the trigger sensor so you can use the lights as normal by turning them ON and OFF manually.
- You have the option to use the "Sun Elevation". This is used for adding a condition to only work when it is dark by setting the suns position to the horizon.
- You have the option to set an Ambient Light Sensor and set the LUX value. This is used for adding a condition to only work when it is dark or below the Ambient Light LUX Value.
- You have the option to set a start time, an end time and select weekdays. This will only allow the automation to run between the time periods.
- You have the option to use the "Zone - Device Tracker". This can be useful if you have pets triggering the trigger sensor turning your lights ON and OFF when no one is home.
- You have the option to use "Night Lights". It is normally used for having lower softer lights come ON when going to the bathroom at night.
Note: If you turn the light on manually and the motion sensor detects motion the light will turn off automatically. It is recommended to use the "Trigger Sensor By-pass" option if you would like to keep the lights ON or OFF for extended time periods.
Required = *
**Need help?** See our FAQ: [Click Here](https://community.home-assistant.io/t/sensor-light-motion-sensor-sun-elevation-lux-value-scenes-time/481048/6)
domain: automation
input:
motion_trigger:
name: Trigger Sensor - Binary Sensors *
description: The Sensor/s that turns the lights ON and OFF. The trigger can be any
[Binary Sensors](https://www.home-assistant.io/integrations/binary_sensor/) you like.
selector:
entity:
domain: binary_sensor
multiple: true
light_switch:
name: Lights - Switches - Scenes *
description: The lights that get turned on by the trigger sensor/s. You can also add switches and scenes.
If adding a scene please read "Scenes To Turn OFF" below.
selector:
target:
entity:
domain:
- light
- switch
- scene
end_scenes:
name: Scenes To Turn OFF
description: If you have selected a scene to be turned ON above in "Lights - Switches - Scenes" or below in "Night Lights" and you would like it to be turned OFF after the time delay,
you must create another identical scene with everything OFF and select it here.
default: []
selector:
entity:
multiple: true
domain:
- scene
time_delay:
name: Time Delay
description: The delay time to leave the lights on after the last trigger from ON to OFF state is detected.
default: 5
selector:
number:
min: 0
max: 30
step: 0.5
unit_of_measurement: minutes
include_light_control:
name: Light Control
description: Select the option you would like to use. It will only control a "light" entity that has a brightness setting.
default: dont_use_brightness
selector:
select:
options:
- label: Use brightness
value: "use_brightness"
- label: Dont use brightness
value: "dont_use_brightness"
light_brightness:
name: Brightness
description: Brightness of the lights when they are turned ON.
default: 100
selector:
number:
min: 1
max: 100
mode: slider
step: 1
unit_of_measurement: '%'
include_bypass:
name: Use The Trigger Sensor By-pass Options (Optional)
description: Select enable or disable. Both of the enable options will allow manual control of your lights.
The enable options are only for selecting what should happen when you turn the by-pass ON and the lights are already ON.
default: bypass_disabled
selector:
select:
options:
- label: Enable the By-pass - If lights are ON, turn lights OFF
value: "bypass_enabled"
- label: Enable the By-pass - If lights are ON, leave lights ON
value: "bypass_enabled_stop"
- label: Disable the By-pass option
value: "bypass_disabled"
motion_bypass:
name: Trigger Sensor By-pass
description: Select a switch that will By-pass the trigger sensor and make your lights function as normal.
The entity cannot be included in, "Lights - Switches - Scenes" and or "Night Lights" selections.
default: []
selector:
entity:
bypass_time_delay:
name: By-pass Time Delay
description: This is only used in two by-pass scenarios when the automation turns the lights OFF if the lights are ON.
The first scenario is when you have selected above to "Enable the By-pass - If lights are ON, turn lights OFF".
And the second scenario is when you turn the by-pass OFF, the trigger sensor is OFF and your lights are ON.
In both scenarios the automation will turn your lights OFF after the set time delay.
default: 0
selector:
number:
min: 0
max: 10
step: 0.25
unit_of_measurement: minutes
include_sun:
name: Use The Sun Option (Optional)
description: Select enable or disable.
default: sun_disabled
selector:
select:
options:
- label: Enable the sun option
value: "sun_enabled"
- label: Disable the sun option
value: "sun_disabled"
sun_elevation:
name: Sun Elevation
description: This is the angle between the sun and the horizon. Negative values mean the sun is BELOW the horizon. Guide is -1.5 (dusk) and -4.0 (dawn).
default: -1.5
selector:
number:
min: -10
max: 5
step: 0.5
unit_of_measurement: degrees
include_ambient:
name: Use The Ambient Options (Optional)
description: Select enable or disable.
default: ambient_disabled
selector:
select:
options:
- label: Enable the ambient options
value: "ambient_enabled"
- label: Disable the ambient options
value: "ambient_disabled"
ambient_light_sensor:
name: Ambient Light Sensor
description: This is used for adding a condition to only work when it is dark or below the Ambient Light LUX Value.
default: []
selector:
entity:
domain: sensor
device_class: illuminance
ambient_light_options:
name: Ambient Light Sensor - Site Conditions
description: In some cases when your lights turn ON your ambient light sensor is affected increasing its LUX value.
This can cause the lights to go OFF prematurely. Please select an option that best suits your installation.
default: ambient_light_option_disabled
selector:
select:
options:
- label: YES - My Ambient Light Sensor is affected by the Lights
value: "ambient_light_option_enabled"
- label: NO - My Ambient Light Sensor is not affected by the Lights
value: "ambient_light_option_disabled"
ambient_light_value:
name: Ambient Light LUX Value
description: Set the Ambient Light LUX Value. Guide is 20 lux (dusk) and 80 lux (dawn).
default: 20
selector:
number:
min: 0
max: 500
step: 10
unit_of_measurement: LUX
include_time:
name: Use The Time Options (Optional)
description: Use the "Start Time", "End Time" and the "Weekdays" values to only run the automation between the time periods.
This applies for "Lights - Switches - Scenes" & "Night Lights".
default: time_disabled
selector:
select:
options:
- label: Enable the time options
value: "time_enabled"
- label: Disable the time options
value: "time_disabled"
after_time:
name: Start Time
description: Set the start time.
default: 00:00:00
selector:
time:
before_time:
name: End Time
description: Set the end time.
default: 00:00:00
selector:
time:
weekday_options:
name: Weekdays
description: Select the days of the week you would like the automation to run. You must select "Enable the time options" above for the weekdays selections to work.
default:
- mon
- tue
- wed
- thu
- fri
- sat
- sun
selector:
select:
multiple: true
mode: list
options:
- label: Monday
value: "mon"
- label: Tuesday
value: "tue"
- label: Wednesday
value: "wed"
- label: Thursday
value: "thu"
- label: Friday
value: "fri"
- label: Saturday
value: "sat"
- label: Sunday
value: "sun"
include_zone:
name: Use The Zone Option (Optional)
description: Home Assistant can track your devices (mobile phones) location to a set zone via the mobile app device tracker.
Enabling this option will only allow the automation to run if a device is in the zone.
This can be useful if you have pets triggering the trigger sensor turning your lights ON and OFF when no one is home.
default: zone_disabled
selector:
select:
options:
- label: Enable the zone option
value: "zone_enabled"
- label: Disable the zone option
value: "zone_disabled"
zone:
name: Zone - Device Tracker
description: Select the zone to track devices in. You must set up a zone and your devices (mobile phones, etc)
to be tracked in Home Assistant for this option to work.
default: []
selector:
entity:
domain: zone
include_night_lights:
name: Use The Night Lights Options (Optional)
description: Use the night lights to only run between the night lights time periods.
This is useful for turning on different lights later in the night and / or setting a lower brightness level,
changing the colour setting or selecting a different scene. It is normally used for having lower softer
lights come ON when going to the bathroom at night.
default: night_lights_disabled
selector:
select:
options:
- label: Enable the night lights options
value: "night_lights_enabled"
- label: Disable the night lights options
value: "night_lights_disabled"
night_lights:
name: Night Lights
description: The night lights that get turned on by the trigger sensor/s. You can also add switches and scenes.
If you have selected a scene and you would like it to be turned OFF after the time delay,
you must create another identical scene with everything OFF and enter it above in the "Scenes To Turn OFF".
default: {}
selector:
target:
entity:
domain:
- light
- switch
- scene
night_time_delay:
name: Night Lights - Time Delay
description: The delay time to leave the night lights on after the last trigger from ON to OFF state is detected.
default: 5
selector:
number:
min: 0
max: 30
step: 0.5
unit_of_measurement: minutes
include_night_light_control:
name: Night Lights - Control
description: Select the option you would like to use. It will only control a "light" entity that has a brightness setting.
default: dont_use_night_brightness
selector:
select:
options:
- label: Use night brightness
value: "use_night_brightness"
- label: Dont use night brightness
value: "dont_use_night_brightness"
night_light_brightness:
name: Night Lights - Brightness
description: Brightness of the night lights when they are turned ON.
default: 20
selector:
number:
min: 1
max: 100
mode: slider
step: 1
unit_of_measurement: '%'
night_lights_after_time:
name: Night Lights - Start Time
description: Set the start time.
default: 00:00:00
selector:
time:
night_lights_before_time:
name: Night Lights - End Time
description: Set the end time.
default: 00:00:00
selector:
time:
# If motion sensor turns ON again within the time delay, it will restart the script.
mode: restart
max_exceeded: silent
variables:
motion_trigger: !input motion_trigger
light_switch: !input light_switch
end_scenes: !input end_scenes
time_delay: !input time_delay
include_light_control: !input include_light_control
light_brightness: !input light_brightness
include_bypass: !input include_bypass
motion_bypass: !input motion_bypass
bypass_time_delay: !input bypass_time_delay
include_sun: !input include_sun
sun_elevation: !input sun_elevation
include_ambient: !input include_ambient
ambient_light_sensor: !input ambient_light_sensor
ambient_light_options: !input ambient_light_options
ambient_light_value: !input ambient_light_value
include_time: !input include_time
after_time: !input after_time
before_time: !input before_time
weekday_options: !input weekday_options
include_zone: !input include_zone
zone: !input zone
include_night_lights: !input include_night_lights
night_lights: !input night_lights
night_time_delay: !input night_time_delay
include_night_light_control: !input include_night_light_control
night_light_brightness: !input night_light_brightness
night_lights_after_time: !input night_lights_after_time
night_lights_before_time: !input night_lights_before_time
trigger:
- platform: state
id: "t1"
entity_id: !input motion_trigger
from: "off"
to: "on"
- platform: numeric_state
id: "t2"
entity_id: sun.sun
attribute: elevation
below: !input sun_elevation
- platform: numeric_state
id: "t3"
entity_id: !input ambient_light_sensor
below: !input ambient_light_value
- platform: time
id: "t4"
at: !input after_time
- platform: time
id: "t5"
at: !input night_lights_after_time
- platform: state
id: "t6"
entity_id: !input motion_bypass
from: "off"
to: "on"
- platform: state
id: "t7"
entity_id: !input motion_bypass
from: "on"
to: "off"
# All Conditions
condition:
#Trigger conditions
- condition: or
conditions:
- condition: and # trigger from off to on
conditions:
- condition: state
entity_id: !input motion_trigger
match: any
state: 'on'
- condition: and # trigger by sun & check motion trigger is on
conditions:
- condition: state
entity_id: !input motion_trigger
state: 'on'
- condition: trigger
id: 't2'
- condition: and # trigger by ambient & check motion trigger is on
conditions:
- condition: state
entity_id: !input motion_trigger
state: 'on'
- condition: trigger
id: 't3'
- condition: and # trigger by time & check motion trigger is on
conditions:
- condition: state
entity_id: !input motion_trigger
state: 'on'
- condition: trigger
id: 't4'
- condition: and # trigger by night time & check motion trigger is on
conditions:
- condition: state
entity_id: !input motion_trigger
state: 'on'
- condition: trigger
id: 't5'
- condition: and # trigger by by-pass turning on
conditions:
- condition: trigger
id: 't6'
- "{{ (include_bypass == 'bypass_enabled') or (include_bypass == 'bypass_enabled_stop') }}"
- condition: and # trigger by by-pass turning off
conditions:
- condition: trigger
id: 't7'
- "{{ (include_bypass == 'bypass_enabled') or (include_bypass == 'bypass_enabled_stop') }}"
# Check Motion Sensor Manual By-pass
- condition: or
conditions:
- "{{ include_bypass == 'bypass_disabled' }}"
- "{{ motion_bypass == [] }}"
- "{{ (include_bypass == 'bypass_enabled') and (states[motion_bypass].state == 'off') }}"
- "{{ (include_bypass == 'bypass_enabled_stop') and (states[motion_bypass].state == 'off') }}"
- condition: trigger
id: 't6'
# Check Sun Elevation
- condition: or
conditions:
- "{{ include_sun == 'sun_disabled' }}"
- "{{ (include_sun == 'sun_enabled') and (state_attr('sun.sun','elevation') <= sun_elevation | float(90)) }}"
# Check Ambient Light Sensor
- condition: or
conditions:
- "{{ include_ambient == 'ambient_disabled' }}"
- "{{ ambient_light_sensor == [] }}"
- "{{ (include_ambient == 'ambient_enabled') and (states[ambient_light_sensor].state | int < ambient_light_value | int) }}"
- "{{ (ambient_light_options == 'ambient_light_option_enabled') and (expand(light_switch.entity_id) | selectattr('state', '==', 'on') | list | count > 0) }}"
- "{{ (ambient_light_options == 'ambient_light_option_enabled') and (expand(night_lights.entity_id) | selectattr('state', '==', 'on') | list | count > 0) }}"
# Check The Time Options
- condition: or
conditions:
- "{{ include_time == 'time_disabled' }}"
- condition: and
conditions:
- condition: time
after: !input after_time
before: !input before_time
weekday: !input weekday_options
- "{{ include_time == 'time_enabled' }}"
# Check if people are in the zone
- condition: or
conditions:
- "{{ include_zone == 'zone_disabled' }}"
- condition: and
conditions:
- condition: numeric_state
entity_id: !input zone
above: 0
- "{{ include_zone == 'zone_enabled' }}"
action:
- choose:
- alias: "Check night lights options"
conditions:
- condition: time
after: !input night_lights_after_time
before: !input night_lights_before_time
- "{{ include_night_lights == 'night_lights_enabled' }}"
sequence:
- choose:
- alias: "By-pass is turned on & check by-pass option - turn lights off"
conditions:
- condition: trigger
id: 't6'
- condition: template
value_template: "{{ include_bypass == 'bypass_enabled' }}"
sequence:
- alias: "Wait the number of minutes set in the by-pass time delay"
delay:
minutes: !input bypass_time_delay
- alias: "Turn off the lights"
service: homeassistant.turn_off
target: !input light_switch
- alias: "Turn off the scenes"
service: scene.turn_on
entity_id: !input end_scenes
- stop: "Stop the automation"
- alias: "By-pass is turned on & check by-pass option - leave lights on"
conditions:
- condition: trigger
id: 't6'
- condition: template
value_template: "{{ include_bypass == 'bypass_enabled_stop' }}"
sequence:
- stop: "Stop the automation"
- alias: "By-pass is turned off & check if the motion trigger is off"
conditions:
- condition: trigger
id: 't7'
- condition: state
entity_id: !input motion_trigger
match: all
state: 'off'
sequence:
- alias: "Wait the number of minutes set in the by-pass time delay"
delay:
minutes: !input bypass_time_delay
- alias: "Turn off the lights"
service: homeassistant.turn_off
target: !input light_switch
- alias: "Turn off the scenes"
service: scene.turn_on
entity_id: !input end_scenes
- stop: "Stop the automation"
- alias: "Reset lights when trigger by night time"
conditions:
- condition: trigger
id: 't5'
sequence:
- service: homeassistant.turn_off
target: !input light_switch
- service: scene.turn_on
entity_id: !input end_scenes
- alias: "Turn on the night lights"
service: homeassistant.turn_on
target: !input night_lights
- choose:
- alias: "Set the brightness for the night light switch"
conditions:
- condition: template
value_template: "{{ include_night_light_control == 'use_night_brightness' }}"
sequence:
- service: light.turn_on
target: !input night_lights
data:
brightness_pct: !input night_light_brightness
- alias: "Wait until motion sensor is off"
wait_for_trigger:
platform: state
entity_id: !input motion_trigger
from: "on"
to: "off"
- alias: "Wait the number of minutes set in the night light time delay"
delay:
minutes: !input night_time_delay
- alias: "Turn off the night lights"
service: homeassistant.turn_off
target: !input night_lights
- alias: "Turn off the scenes"
service: scene.turn_on
entity_id: !input end_scenes
default:
- choose:
- alias: "By-pass is turned on & check by-pass option - turn lights off"
conditions:
- condition: trigger
id: 't6'
- condition: template
value_template: "{{ include_bypass == 'bypass_enabled' }}"
sequence:
- alias: "Wait the number of minutes set in the by-pass time delay"
delay:
minutes: !input bypass_time_delay
- alias: "Turn off the lights"
service: homeassistant.turn_off
target: !input light_switch
- alias: "Turn off the scenes"
service: scene.turn_on
entity_id: !input end_scenes
- stop: "Stop the automation"
- alias: "By-pass is turned on & check by-pass option - leave lights on"
conditions:
- condition: trigger
id: 't6'
- condition: template
value_template: "{{ include_bypass == 'bypass_enabled_stop' }}"
sequence:
- stop: "Stop the automation"
- alias: "By-pass is turned off & check if the motion trigger is off"
conditions:
- condition: trigger
id: 't7'
- condition: state
entity_id: !input motion_trigger
match: all
state: 'off'
sequence:
- alias: "Wait the number of minutes set in the by-pass time delay"
delay:
minutes: !input bypass_time_delay
- alias: "Turn off the lights"
service: homeassistant.turn_off
target: !input light_switch
- alias: "Turn off the scenes"
service: scene.turn_on
entity_id: !input end_scenes
- stop: "Stop the automation"
- alias: "Turn on the lights"
service: homeassistant.turn_on
target: !input light_switch
- choose:
- alias: "Set the brightness for the light switch"
conditions:
- condition: template
value_template: "{{ include_light_control == 'use_brightness' }}"
sequence:
- service: light.turn_on
target: !input light_switch
data:
brightness_pct: !input light_brightness
- alias: "Wait until motion sensor is off"
wait_for_trigger:
platform: state
entity_id: !input motion_trigger
from: "on"
to: "off"
- alias: "Wait the number of minutes set in the light time delay"
delay:
minutes: !input time_delay
- alias: "Turn off the lights"
service: homeassistant.turn_off
target: !input light_switch
- alias: "Turn off the scenes"
service: scene.turn_on
entity_id: !input end_scenes
CHANGELOG
- Version: 2.8: - 19 Feb-23 - Fixed bug in the by-pass. Added By-pass Time Delay.
- Version: 2.7: - 18 Feb-23 - When the by-pass is turned OFF, trigger is re-evaluated.
- Version: 2.6: - 5 Feb-23 - Added a new option to the by-pass.
- Version: 2.5: - 25 Jan-23 - Cleaned up by-pass selection.
- Version: 2.4: - 16 Jan-23 - Added weekday selection.
- Version: 2.3: - 15 Jan-23 - Removed wording description for clearing 2 entities selections.
- Version: 2.2: - 6 Jan-23 - Fixed bug in night lights flickering on trigger.
- Version: 2.1: - 5 Jan-23 - Added brightness control, Zone - Device Tracker & Night Lights options.
- Version: 2.0: - 15 Dec-22 - Upgrade option for the LUX sensor.
- Version: 1.9: - 29 Nov-22 - Bug fix when using multiple entities in “Trigger Sensor - Binary Sensors”
- Version: 1.8: - 20 Nov-22 - More user friendly selection for enabling and disabling options and Bug Fix
- Version: 1.7: - 15 Nov-22 - You can add any Binary Sensors you like as the trigger.
- Version: 1.6: - 14 Nov-22 - You can add scenes.
- Version: 1.5: - 9 Nov-22 - You can add a start time and an end time (Optional).
- Version: 1.4: - 5 Nov-22 - You can add as many motion sensors as you like.
- Version: 1.3: - 3 Nov-22 - Ambient Light Sensor and set the LUX value (Optional).
- Version: 1.2: - 2 Nov-22 - Motion Sensor By-pass (Optional).
- Version: 1.1: - 28 Oct-22 - Initial release
MY OTHER BLUEPRINTS
Smart Relay - Contactor
Push Button Relay - Contactor
Toilet Exhaust Fan with time delay
Timer Relay - Run ON Timer
Entity - Run ON Timer
Bathroom Humidity Exhaust Fan
Temperature Control Exhaust Fan
Temperature Control Exhaust Fan - Inverted
Turn Light, Switch or Scene On & Off with Trigger Conditions
May be my ideas could be also implemented here in the future. Or even I can help (but this is not the near future 
Glad your liking the blueprint. It is nice to hear feature requests so thank you.