adaptive-lighting/docs/index.md
Marijn Eken 8f78233e11
docs: clarify that UI setup needs no YAML entry (#1031)
* Fixed outdated info in README.md

The README says to always add an adaptive_lighting: entry in the YAML, where this seems to be no longer needed (or even preferred).

* docs: clarify YAML is optional for UI setup

---------

Co-authored-by: Bas Nijholt <basnijholt@users.noreply.github.com>
Co-authored-by: Bas Nijholt <bas@nijho.lt>
2026-09-06 10:43:37 +02:00

3.6 KiB

icon
lucide/sun

Adaptive Lighting

Enhance Your Home's Atmosphere with Smart, Sun-Synchronized Lighting

Adaptive Lighting Logo

Adaptive Lighting is a custom component for Home Assistant that intelligently adjusts the brightness and color of your lights based on the sun's position, while still allowing for manual control.

By automatically adapting the settings of your lights throughout the day, Adaptive Lighting helps maintain your natural circadian rhythm, which can lead to improved sleep, mood, and overall well-being. Experience cooler color temperatures at noon, gradually transitioning to warmer colors at sunset and sunrise.

Features

When initially turning on a light that is controlled by Adaptive Lighting, the light.turn_on service call is intercepted, and the light's brightness and color are automatically adjusted based on the sun's position. After that, the light's brightness and color are automatically adjusted at a regular interval.

Adaptive Lighting provides four switches (using "living_room" as an example component name):

  • switch.adaptive_lighting_living_room: Turn Adaptive Lighting on or off and view current light settings through its attributes.
  • switch.adaptive_lighting_sleep_mode_living_room: Activate "sleep mode" 😴 and set custom sleep_brightness and sleep_color_temp.
  • switch.adaptive_lighting_adapt_brightness_living_room: Enable or disable brightness adaptation 🔆 for supported lights.
  • switch.adaptive_lighting_adapt_color_living_room: Enable or disable color adaptation 🌈 for supported lights.

Quick Start

  1. Install via HACS: Search for "Adaptive Lighting" in the Home Assistant Community Store
  2. Add the integration: Go to SettingsDevices & ServicesAdd IntegrationAdaptive Lighting, then name your instance
  3. Configure: Open Adaptive Lighting, click Configure, select your lights, and adjust the settings. No YAML entry is needed.

Get Started →{ .md-button .md-button--primary } View All Options →{ .md-button }

How It Works

Adaptive Lighting provides four switches for each configuration (using "living_room" as an example):

Switch Purpose
switch.adaptive_lighting_living_room Main on/off control
switch.adaptive_lighting_sleep_mode_living_room Activate sleep mode
switch.adaptive_lighting_adapt_brightness_living_room Enable/disable brightness adaptation
switch.adaptive_lighting_adapt_color_living_room Enable/disable color adaptation

Interactive Simulator

Visualize how Adaptive Lighting will work with your settings using the interactive simulator: