gitwtfhub

wtf is inovelli-scene-pairing?

dbhagen/inovelli-scene-pairing — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TL;DR

A Home Assistant integration that lets you group Inovelli Blue smart switches so they mirror each other's on/off, dimming, and color, controlled entirely by pressing the switches.

Mindmap

mindmap
  root((inovelli-scene-pairing))
    What it does
      Mirrors switch groups
      Zigbee-level pairing
      LED color control
    Tech stack
      Home Assistant
      ZHA
      HACS
    Use cases
      Multi-switch lighting groups
      Dashboard group management
      Custom automations
    Audience
      Smart home hobbyists
      Home Assistant users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Group multiple Inovelli Blue switches so they mirror on/off and dimming without writing automations.

REASON 2

Set a shared LED bar color for a group of switches directly from the physical buttons.

REASON 3

Manage switch groups from a Home Assistant dashboard panel instead of the physical hardware.

REASON 4

Trigger group actions from your own Home Assistant automations using the exposed services.

What's in the stack?

PythonHome AssistantZHAHACS

How it stacks up

dbhagen/inovelli-scene-pairing0-bingwu-0/live-interpreter0cm-labs/tokenizer-benchmark
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencegeneralgeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Home Assistant with ZHA (not Zigbee2MQTT) and specific Inovelli Blue switch models.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

This is a Home Assistant add-on that lets you group Inovelli Blue smart switches together so they mirror each other, entirely by pressing buttons on the physical switches themselves. Once switches are grouped, turning one on or off, dimming it, or changing its light color instantly does the same to the rest of the group, even if Home Assistant is offline, because the grouping happens directly over the Zigbee radio protocol rather than through automations. You pair switches by holding a small config button on one switch to open a pairing window, then holding the button on another switch to add it to the group, and so on for more switches. A single tap while pairing cycles through a color palette for the group's LED indicator bar, and a double tap removes a switch from its group. Every one of these gestures can be remapped in the integration's settings, and the whole physical-gesture system can be turned off in favor of a dashboard-only setup. The integration also adds an optional sidebar panel and dashboard card so groups can be created, recolored, and deleted from the Home Assistant interface instead of the physical switches, and it exposes services so these actions can be used inside your own automations. It only supports two specific Inovelli switch models and requires the ZHA integration for Zigbee, not Zigbee2MQTT. Installation goes through HACS, the Home Assistant Community Store, by adding this repository as a custom integration and restarting Home Assistant afterward. The README also documents common troubleshooting steps, like re-pairing a switch in ZHA if its config button stops responding after a fresh Zigbee pairing. The project is licensed under the MIT License.

Yoink these prompts

Prompt 1
Walk me through installing this integration via HACS in Home Assistant.
Prompt 2
Explain how to pair three Inovelli switches into one mirrored group using the config button.
Prompt 3
Help me remap the double-tap gesture to something else in the integration options.
Prompt 4
Show me how to use the create_group and set_color services in my own automation.

Frequently asked questions

wtf is inovelli-scene-pairing?

A Home Assistant integration that lets you group Inovelli Blue smart switches so they mirror each other's on/off, dimming, and color, controlled entirely by pressing the switches.

What language is inovelli-scene-pairing written in?

Mainly Python. The stack also includes Python, Home Assistant, ZHA.

What license does inovelli-scene-pairing use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is inovelli-scene-pairing to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is inovelli-scene-pairing for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.