Home

HA Light Controller

Home Assistant custom integration — reliable light control with state verification, automatic retries, and preset management.

Distributed via HACS. Current release: v0.3.0

---

What It Does

HA Light Controller solves a common Home Assistant problem: light commands don't always stick. This integration sends commands and then verifies that lights actually reached their target state — retrying automatically if they didn't.

Key capabilities:

• State verification — checks lights reached the target after every command
• Automatic retries — exponential backoff until lights comply or timeout
• Preset management — named light scenes with per-entity overrides
• Group expansion — light.* and group.* entities are resolved to individual lights
• Button & sensor entities — activate presets via UI, track status in dashboards

---

Installation

Recommended: HACS

1. Open HACS → Integrations → Custom repositories
2. Add https://github.com/L3DigitalNet/ha-light-controller (category: Integration)
3. Install HA Light Controller
4. Restart Home Assistant
5. Add the integration via Settings → Devices & Services → Add Integration

Manual

Copy custom_components/ha_light_controller/ into your HA config/custom_components/ directory and restart.

---

Services

Service	Description
ha_light_controller.ensure_state	Control lights with verification and retries
ha_light_controller.activate_preset	Activate a saved preset by name or ID
ha_light_controller.create_preset	Create a preset programmatically
ha_light_controller.create_preset_from_current	Capture current light states as a preset
ha_light_controller.delete_preset	Delete a preset by ID

---

Wiki Pages

• Usage — full service reference, YAML examples, preset configuration
• Changelog — version history

---

Requirements

• Home Assistant 2025.2.0+
• Python 3.13+

---

Source: L3DigitalNet/ha-light-controller