Skip to content

Getting Started

This guide will help you install and configure Adaptive Lighting for the first time.

Prerequisites

Installation

  1. Open HACS in your Home Assistant instance
  2. Click on Integrations
  3. Click the + Explore & Download Repositories button
  4. Search for "Adaptive Lighting"
  5. Click Download
  6. Restart Home Assistant

Or use this button to open HACS directly:

Open your Home Assistant instance and open the Adaptive Lighting integration inside the Home Assistant Community Store.

Manual Installation

  1. Download the latest release from GitHub
  2. Extract the adaptive_lighting folder to your config/custom_components/ directory
  3. Restart Home Assistant

Configuration

Step 1: Add to configuration.yaml

Add the following to your configuration.yaml:

adaptive_lighting:

Note

This entry is required even if you plan to configure everything through the UI.

Step 2: Restart Home Assistant

Restart Home Assistant for the changes to take effect.

Step 3: Add the Integration

  1. Go to Settings → Devices & Services
  2. Click + Add Integration
  3. Search for "Adaptive Lighting"
  4. Follow the setup wizard to select your lights

Step 4: Configure Your Lights

You can configure Adaptive Lighting in two ways:

  1. Go to Settings → Devices & Services
  2. Find Adaptive Lighting and click Configure
  3. Adjust settings as needed
adaptive_lighting:
  - name: "Living Room"
    lights:
      - light.living_room_ceiling
      - light.living_room_lamp
    min_brightness: 20
    max_brightness: 100
    min_color_temp: 2200
    max_color_temp: 5500

Basic Configuration Example

Here's a simple configuration to get you started:

adaptive_lighting:
  - name: "Main Lights"
    lights:
      - light.living_room
      - light.bedroom
      - light.kitchen
    transition: 30
    min_brightness: 10
    max_brightness: 100
    min_color_temp: 2000
    max_color_temp: 5500

Verifying Installation

After configuration, you should see new switches in Home Assistant:

  • switch.adaptive_lighting_main_lights
  • switch.adaptive_lighting_sleep_mode_main_lights
  • switch.adaptive_lighting_adapt_brightness_main_lights
  • switch.adaptive_lighting_adapt_color_main_lights

Turn on switch.adaptive_lighting_main_lights to start adapting your lights!

Next Steps