adaptive-lighting/docs/configuration.md

icon
lucide/settings

Configuration

Adaptive Lighting supports configuration through both YAML and the Home Assistant UI, with identical option names in both methods.

Basic Configuration

The minimal configuration requires only adding the integration to your configuration.yaml:

adaptive_lighting:

You can then configure everything through the UI at Settings → Devices & Services → Adaptive Lighting → Configure.

YAML Configuration

For YAML configuration, you can specify lights and options directly:

adaptive_lighting:
  - name: "Living Room"
    lights:
      - light.living_room_ceiling
      - light.living_room_lamp

All Options

All configuration options are listed below with their default values. These options work identically in both YAML and the UI.

Full Configuration Example

Multiple Configurations

You can create multiple Adaptive Lighting configurations for different areas or use cases:

adaptive_lighting:
  - name: "Daytime Spaces"
    lights:
      - light.living_room
      - light.kitchen
      - light.office
    min_brightness: 30
    max_brightness: 100

  - name: "Bedroom"
    lights:
      - light.bedroom_ceiling
      - light.bedroom_lamp
    min_brightness: 5
    max_brightness: 80
    sleep_brightness: 1
    sleep_color_temp: 1000

  - name: "Night Lights"
    lights:
      - light.hallway_night
      - light.bathroom_night
    min_brightness: 1
    max_brightness: 20

Option Categories

Brightness Settings

Option	Description
min_brightness	Minimum brightness (1-100%)
max_brightness	Maximum brightness (1-100%)
brightness_mode	How brightness changes (default, linear, tanh)
brightness_mode_time_dark	Ramp duration before/after sunrise/sunset
brightness_mode_time_light	Ramp duration after/before sunrise/sunset

See Brightness Modes for detailed explanations.

Color Temperature Settings

Option	Description
min_color_temp	Warmest temperature in Kelvin
max_color_temp	Coldest temperature in Kelvin
prefer_rgb_color	Use RGB instead of color temperature

Sleep Mode Settings

Option	Description
sleep_brightness	Brightness in sleep mode (1-100%)
sleep_color_temp	Color temperature in sleep mode
sleep_rgb_color	RGB color for sleep mode
sleep_transition	Transition duration for sleep mode
transition_until_sleep	Gradually transition to sleep settings after sunset

See Sleep Mode for more details.

Manual Control Settings

Option	Description
take_over_control	Detect manual changes and pause adaptation
detect_non_ha_changes	Detect changes made outside Home Assistant
autoreset_control_seconds	Auto-reset manual control after this many seconds

See Manual Control for detailed behavior.

Timing Settings

Option	Description
sunrise_time	Fixed sunrise time (overrides actual)
sunset_time	Fixed sunset time (overrides actual)
sunrise_offset	Offset from actual sunrise in seconds
sunset_offset	Offset from actual sunset in seconds
min_sunrise_time / max_sunrise_time	Constrain virtual sunrise
min_sunset_time / max_sunset_time	Constrain virtual sunset

Transition Settings

Option	Description
transition	Duration for regular transitions (seconds)
initial_transition	Duration when lights first turn on
interval	How often to adapt lights (seconds)