mirror of
https://github.com/basnijholt/adaptive-lighting.git
synced 2026-09-15 08:14:04 +02:00
3b1b84e7e8
Adds one `number.adaptive_lighting_intensity_<name>` entity per
configuration, alongside the Sleep Mode / Adapt Brightness / Adapt Color
switches on the same device. It is a 0-100% slider that interpolates the
adaptive result towards the switch's floor:
output = floor_value + (adaptive_value - floor_value) * intensity / 100
100 short-circuits and returns the adaptive value untouched, so it is the
default and existing configurations behave exactly as before. 0 returns
the floor. In between the light stays fully adaptive -- the sun still
moves it at every setting, so it is a scaled curve rather than a frozen
level, which is what distinguishes this from simply scaling the
brightness band.
The floor is set by a new per-switch `intensity_floor` option: the
switch's sleep settings (`sleep_brightness`/`sleep_color_temp`) by
default, or its `min_brightness`/`min_color_temp`.
`transition_until_sleep` forces the sleep floor whatever `intensity_floor`
says. With that option on, the adaptive color temperature after sunset
descends below `min_color_temp` towards `sleep_color_temp`, so a
`min_color_temp` floor would sit above the adaptive value and turning the
dial down would make the light cooler.
Documented in the README's features and a new Intensity section, and on
the docs site as advanced/intensity.md.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
76 lines
4 KiB
Markdown
76 lines
4 KiB
Markdown
---
|
|
icon: lucide/sun
|
|
---
|
|
|
|
# Adaptive Lighting
|
|
|
|
**Enhance Your Home's Atmosphere with Smart, Sun-Synchronized Lighting**
|
|
|
|
<div style="text-align: center; margin: 2rem 0;">
|
|
<img src="assets/logo.png" alt="Adaptive Lighting Logo" width="200" />
|
|
</div>
|
|
|
|
[Adaptive Lighting](https://github.com/basnijholt/adaptive-lighting) is a custom component for [Home Assistant](https://www.home-assistant.io/) that intelligently adjusts the brightness and color of your lights based on the sun's position, while still allowing for manual control.
|
|
|
|
<div style="text-align: center; margin: 2rem 0;">
|
|
<a href="https://my.home-assistant.io/redirect/hacs_repository/?owner=basnijholt&repository=adaptive-lighting&category=integration" class="md-button md-button--primary">
|
|
Install via HACS
|
|
</a>
|
|
<a href="simulator/" class="md-button">
|
|
Try the Simulator
|
|
</a>
|
|
</div>
|
|
|
|
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
|
|
|
|
<!-- CODE:START -->
|
|
<!-- from adaptive_lighting.docs_gen import _transform_readme_links -->
|
|
<!-- print(_transform_readme_links(include_section("../README.md", "features", strip_heading=True))) -->
|
|
<!-- CODE:END -->
|
|
<!-- OUTPUT:START -->
|
|
<!-- ⚠️ This content is auto-generated by `markdown-code-runner`. -->
|
|
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 and a number entity (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.
|
|
- `number.adaptive_lighting_living_room_intensity`: Scale 🎚️ how far the adaptive settings travel from their floor, from 100% (unchanged) down to 0%.
|
|
|
|
<!-- OUTPUT:END -->
|
|
|
|
## Quick Start
|
|
|
|
1. **Install via HACS**: Search for "Adaptive Lighting" in the [Home Assistant Community Store](https://hacs.xyz/)
|
|
2. **Add the integration**: Go to **Settings** → **Devices & Services** → **Add Integration** → **Adaptive 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 →](getting-started.md){ .md-button .md-button--primary }
|
|
[View All Options →](configuration.md){ .md-button }
|
|
|
|
## How It Works
|
|
|
|
Adaptive Lighting provides four switches and a number entity for each configuration (using "living_room" as an example):
|
|
|
|
| Entity | 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 |
|
|
| `number.adaptive_lighting_living_room_intensity` | [Scale the adaptive curve](advanced/intensity.md) towards its floor |
|
|
|
|
## Interactive Simulator
|
|
|
|
Visualize how Adaptive Lighting will work with your settings using the interactive simulator:
|
|
|
|
<div style="text-align: center; margin: 2rem 0;">
|
|
<a href="simulator/" class="simulator-link">
|
|
Try the Interactive Simulator
|
|
</a>
|
|
</div>
|