adaptive-lighting/docs/advanced/sleep-mode.md
Bas Nijholt f5877076ce Add documentation site with Zensical framework
Create comprehensive documentation site for adaptive-lighting.nijho.lt:

- Add zensical.toml configuration with Material theme (amber/orange)
- Create docs_gen.py module for extracting README sections via markers
- Add section markers to README.md for content reuse
- Create documentation pages:
  - index.md: Home with features overview
  - getting-started.md: Installation and quick setup
  - configuration.md: Auto-generated config options table
  - services.md: Auto-generated service documentation
  - automation-examples.md: Real-world automation recipes
  - troubleshooting.md: Common issues and solutions
  - see-also.md: External resources and links
  - advanced/brightness-modes.md: Brightness mode deep dive
  - advanced/manual-control.md: Manual control system docs
  - advanced/sleep-mode.md: Sleep mode configuration
- Add GitHub Actions workflow for building and deploying to Pages
- Add custom CSS with sun-themed styling
- Add CNAME for custom domain

Uses markdown-code-runner to auto-generate content from code schemas
and extract README sections for single-source documentation.
2026-01-12 09:52:16 -08:00

4.8 KiB

icon
lucide/moon

Sleep Mode

Sleep mode is a special operating mode that sets your lights to minimal brightness and very warm color, perfect for winding down at night without disrupting your circadian rhythm.

Overview

When sleep mode is activated, Adaptive Lighting overrides normal sun-based calculations with fixed sleep settings:

Setting Default Description
sleep_brightness 1% Very dim lighting
sleep_color_temp 1000K Very warm (candlelight)
sleep_rgb_color [255, 56, 0] Deep orange/red
sleep_transition 1 second Quick transition

Activating Sleep Mode

Each Adaptive Lighting configuration creates a sleep mode switch:

switch.adaptive_lighting_sleep_mode_<name>

Turn it on to activate sleep mode:

service: switch.turn_on
target:
  entity_id: switch.adaptive_lighting_sleep_mode_living_room

Configuration Options

sleep_brightness

Sets the brightness level during sleep mode (1-100%).

adaptive_lighting:
  - name: "Bedroom"
    lights:
      - light.bedroom
    sleep_brightness: 1  # Barely visible

sleep_rgb_or_color_temp

Choose whether to use color temperature or RGB color in sleep mode:

Value Description
color_temp Use sleep_color_temp (default)
rgb_color Use sleep_rgb_color

sleep_color_temp

The color temperature in Kelvin during sleep mode (when using color_temp mode).

adaptive_lighting:
  - name: "Bedroom"
    lights:
      - light.bedroom
    sleep_rgb_or_color_temp: color_temp
    sleep_color_temp: 1000  # Very warm

sleep_rgb_color

The RGB color during sleep mode (when using rgb_color mode). Useful for bulbs that don't support very low color temperatures.

adaptive_lighting:
  - name: "Bedroom"
    lights:
      - light.bedroom
    sleep_rgb_or_color_temp: rgb_color
    sleep_rgb_color: [255, 56, 0]  # Deep orange/red

sleep_transition

The transition duration when entering or exiting sleep mode.

adaptive_lighting:
  - name: "Bedroom"
    lights:
      - light.bedroom
    sleep_transition: 10  # Slow 10-second transition

transition_until_sleep

When enabled, Adaptive Lighting treats sleep settings as the minimum values and gradually transitions to them after sunset. This creates a natural wind-down effect.

adaptive_lighting:
  - name: "Evening wind-down"
    lights:
      - light.living_room
    transition_until_sleep: true
    sleep_brightness: 10
    sleep_color_temp: 2000

Automation Examples

Enable Sleep Mode at Bedtime

automation:
  - alias: "Bedtime - enable sleep mode"
    trigger:
      - platform: time
        at: "22:00:00"
    action:
      - service: switch.turn_on
        target:
          entity_id:
            - switch.adaptive_lighting_sleep_mode_bedroom
            - switch.adaptive_lighting_sleep_mode_hallway

Sync with Input Boolean

input_boolean:
  sleep_mode:
    name: "Sleep Mode"
    icon: mdi:sleep

automation:
  - alias: "Toggle sleep mode switches"
    trigger:
      - platform: state
        entity_id: input_boolean.sleep_mode
    action:
      - service: "switch.turn_{{ states('input_boolean.sleep_mode') }}"
        target:
          entity_id:
            - switch.adaptive_lighting_sleep_mode_bedroom
            - switch.adaptive_lighting_sleep_mode_living_room

Disable Sleep Mode at Wake Time

automation:
  - alias: "Morning - disable sleep mode"
    trigger:
      - platform: time
        at: "07:00:00"
    action:
      - service: switch.turn_off
        target:
          entity_id:
            - switch.adaptive_lighting_sleep_mode_bedroom
            - switch.adaptive_lighting_sleep_mode_living_room

Motion-Activated Night Light

automation:
  - alias: "Hallway night light"
    trigger:
      - platform: state
        entity_id: binary_sensor.hallway_motion
        to: "on"
    condition:
      - condition: time
        after: "22:00:00"
        before: "06:00:00"
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.adaptive_lighting_sleep_mode_hallway
      - service: light.turn_on
        target:
          entity_id: light.hallway
      - wait_for_trigger:
          - platform: state
            entity_id: binary_sensor.hallway_motion
            to: "off"
            for: "00:02:00"
      - service: light.turn_off
        target:
          entity_id: light.hallway

Best Practices

  1. Use very low brightness (1-5%) for true sleep mode
  2. Use warm colors (1000-2000K) to minimize blue light exposure
  3. Consider RGB mode if your bulbs can't achieve very warm temperatures
  4. Set up automations to automatically enable/disable sleep mode
  5. Use transition_until_sleep for a gradual evening wind-down