Home Assistant Aqara Lighting Integration

Developer Hub
, , , ,
1

I’m pleased to announce the release of my Home Assistant Aqara lighting integration for the T1M Ceiling Light, T1 LED Strip and T2 bulbs. It’s still in beta phase (v0.3.0) but has the base features implemented now and is ready for public testing.

Overview
Easily control Aqara lights with RGB dynamic effects, individual segment patterns, gradients, CCT sequences, and state restoration.

Features

  • Aqara App Effect Presets - Quick access to 24 preset effects from the Aqara mobile app
    • 4 T2 Bulb presets (Candlelight, Breath, Colorful, Security)
    • 9 T1M presets (Dinner, Sunset, Autumn, Galaxy, Daydream, Holiday, Party, Meteor, Alert)
    • 7 T1 Strip presets (Rainbow, Heartbeat, Gala, Sea of Flowers, Rhythmic, Exciting, Colorful)
  • Segment Pattern Presets - 12 T1M/T1 Strip segment color patterns from the Aqara app
  • Dynamic RGB Effects - 13 different manual effects including breathing, fading, flowing, chasing, rainbow, and more
  • Effect Dropdown Selector - Easy-to-use UI dropdown showing all available effects and presets
  • RGB Color Pickers - Color picker UI for all services (up to 8 colors for effects, 6 for gradients)
  • Individual Segment Control - Set custom colors for each segment on T1M and T1 Strip lights
  • Smooth Color Gradients - Create color transitions across segments with 2-6 colors
  • Color Block Patterns - Generate evenly spaced or alternating color blocks
  • Flexible Segment Selection - Support for ranges (“1-20”), individual segments, and special selectors (“odd”, “even”)
  • CCT Dynamic Sequences - Create multi-step color temperature and brightness sequences with smooth transitions
  • T1 Strip Variable Length Support - Automatically detects and adapts to T1 Strip’s length (1-10 meters)
  • Light Group Support - All services work with Home Assistant light groups for synchronized multi-light control
  • Auto Turn-On Option - Optionally turn lights on automatically before applying effects or sequences
  • Unspecified Segment Control - Option to turn off segments not included in patterns
  • Automatic Device Discovery - Discovers supported Aqara lights through Zigbee2MQTT
  • Service-Based API - All features accessible via Home Assistant services, automations, and scripts

Usage

All features are available as Home Assistant services. Call these services from automations, scripts, or the Developer Tools.

Requirements

  • Home Assistant 2025.12.0 or newer (older versions not tested)
  • MQTT integration configured and running
  • Zigbee2MQTT 2.7.2 or newer

Full details on the Github page.

6 Likes
2

New in v.0.4.0

Frontend Panel

A new UI panel has been added to the Home Assistant sidebar for easy access to presets:

  • Sidebar Integration - Access the “Aqara Lighting” panel directly from the Home Assistant sidebar
  • UI Buttons - Interface for managing lights, effects, and sequences
  • Preset Buttons - Access to all effect and sequence presets
  • Built with Lit - Modern, lightweight web component framework for optimal performance
  • More features to be added soon

The panel provides a centralized location for controlling Aqara lights without needing to use the Developer Tools or create automations.

RGB Segment Sequences

Create animated segment patterns with the segment sequence feature:

Key Features:

  • Up to 20 Customizable Steps - Build multi-step sequences
  • Multiple Activation Patterns:
    • Sequential forward/reverse - Segments activate one by one
    • Random - Segments activate in random order
    • Simultaneous - All segments activate at once
  • Pattern Modes:
    • Gradient - Smooth color transitions across segments
    • Blocks (repeat/expand) - Evenly spaced color blocks
    • Individual - Custom color per segment
  • Timing Control:
    • Duration - Time to complete the activation pattern
    • Hold - Time to hold after activation completes
  • Loop Options:
    • Run once, loop X times, or continuous loop
    • Choose to maintain state or turn off when complete
  • Pause and Resume - Control sequence playback mid-execution

New Services:

  • start_segment_sequence - Start an RGB segment sequence
  • stop_segment_sequence - Stop a running sequence
  • pause_segment_sequence - Pause a running sequence
  • resume_segment_sequence - Resume a paused sequence

CCT Sequence Enhancements

The existing CCT sequence feature has been enhanced with pause and resume functionality:

New Services:

  • pause_cct_sequence - Pause a running CCT sequence while maintaining current state
  • resume_cct_sequence - Resume a paused CCT sequence from where it was paused
3 Likes
3

Pleased to announce v0.5.0, a major feature release that brings frontend visual effect and pattern editors, and a preset management system. This release focuses on enhancing the frontend user experience with intuitive creation tools while maintaining full backend compatibility. Update via HACS, and be sure to hard refresh the browser to clear any cached previous version.

Enhanced Panel UI with Visual Editors

The sidebar panel now includes interactive visual editors for creating custom effects, patterns, and sequences:

  • Effect Editor - Create custom dynamic RGB effects
    • Effect type selector
    • Up to 8 color pickers for effect colors
    • Speed and brightness sliders
    • Segment selector for T1 Strip effects
    • Live preview of effect settings
    • Save as custom preset
  • Segment Pattern Editor - Design custom segment color patterns
    • Visual segment selector showing all available segments
    • Color picker for each segment or range
    • Gradient and block pattern generators
    • Turn off unspecified segments option
    • Save as custom preset
  • CCT Sequence Editor - Build multi-step CCT sequences
    • Up to 20 steps with visual timeline
    • Color temperature and brightness sliders for each step
    • Transition and hold duration controls
    • Loop mode and end behavior settings
    • Live step preview
    • Save as custom preset
  • RGB Segment Sequence Editor - Create animated segment sequences
    • Up to 20 steps with animation patterns
    • Multiple color modes (gradient, blocks, individual)
    • Activation pattern selector with 8 options (all at once, sequential forward/reverse, random, ping pong, centre out, edges in, paired)
    • Duration and hold controls
    • Loop settings with skip first step option
    • Clear segments before starting option
    • Save as custom preset

User Preset System

Create, save, and manage your own custom presets for all feature types:

  • Preset Management - Full CRUD operations for user-created presets
    • Create unlimited custom presets
    • Edit existing presets with full customization
    • Duplicate presets to create variations
    • Delete unwanted presets
  • Supported Preset Types - Save presets for all features
    • Effect presets (dynamic RGB effects with colors and settings)
    • Segment pattern presets (custom segment color arrangements)
    • CCT sequence presets (multi-step color temperature sequences)
    • RGB segment sequence presets (animated segment patterns)
  • Persistent Storage - Presets stored across Home Assistant restarts
    • Automatic save on creation/update/delete
    • UUID-based preset IDs for reliable tracking
    • Timestamps for created and modified dates to allow for sorting

activate
activate2177×2940 213 KB

effects
effects2174×1476 106 KB

pattern
pattern2171×1485 104 KB

segments
segments2173×2296 177 KB

cct
cct2174×1546 108 KB

1 Like
4

New in v0.6.0 is a Device Config panel which allows you to apply configuration settings to multiple Aqara lights at the same time. Available settings are filtered according to which kind of devices are selected, and only the compatible settings are sent to each device.

For T2 bulbs these include a visual editor for transition curvature with draggable adjustment graph.

Full details of the update are in the changelog.

devices
devices2171×1802 107 KB

2 Likes
5

Wow, this is super cool! Very nice job.

Do you think you’ll ever make it work with ZHA?

1 Like
6

Thanks. I have no plans to at the moment unfortunately, support for the lights features would need to be added to ZHA itself first.

2 Likes
7

Since my last post the integration is now up to v0.11.0, new features include:

  • Segment Zone Naming - Assign custom names to segment zones on each device with a visual grid editor for intuitive zone configuration
  • Device triggers for HA automations - Aqara lighting devices now appear in the Home Assistant automation UI device trigger selector, enabling native trigger-based automations of features
  • Interactive Visual Segment Selection for segment patterns and sequences
  • XY Color Picker Modal - with color history swatches
  • Dynamic SVG preset preview thumbnails - Presets now display dynamically generated SVG thumbnail previews showing the actual color pattern
  • Advanced Gradient Creation - Interpolation mode selector, mirroring and wave easing
  • Per-user preferences with server-side storage - User preferences are stored on the server, persisting across browsers and devices
  • REST API Trigger Endpoint- Trigger presets from external systems such as Node-RED or iOS shortcuts
  • Multiple Zigbee2MQTT Instance Support
  • User Preset Backup and Restore

Many more features and improvements have also been implemented.

It’s also now installable directly through HACS, just search for Aqara Advanced Lighting within the Home Assistant Community Store in your HA iinstallation.

1 Like
8

Very nice! it makes me want to install Zigbee2MQTT.

Requirements

  • Home Assistant 2025.12.0 or newer (older versions not tested)
  • MQTT integration configured and running
  • Zigbee2MQTT 2.7.2 or newer
1 Like
9

Thanks. Unfortunately ZHA or Matter just aren’t capable of such features with the lights.

10

wow! very nice. And such love to Aqara’s lights. I think you could expand this and see great traction if it were more open, but I understand your interests. Well done.

1 Like
11

Thanks. In the long run I may well add support for other manufacturers once I run out of things to do with the Aqara lights I have or if they stop releasing new lights with new features to explore. I really want to get one of the new V1 Sky Mirror ceiling lights to reverse engineer.

It really just grew out my want to add the T2 bulb effects to Home Assistant and then ballooned from there as a fun side project to play around with.

1 Like
12

Awesome ! Great job :clap: and so passionated :x2fozabcpx9xrbxmdpseb3_61:

1 Like