ControllerX
Create controller-based automations with ease to control your home devices and scenes from Home Assistant (HA).
ControllerX brings the following functionalities to many controllers:
- Turn on/off any home device (light, switch, media player, etc.)
- Manual increase/decrease of brightness and color temperature
- Smooth increase/decrease (holding a button) of brightness, color temperature, volume, etc.
- Color loop if the light supports xy color
- Play/pause music
- Open/close covers
Get started Find your controller Build your configuration
Why ControllerX?
Solutions like Zigbee2MQTT, deCONZ and ZHA have their pros and cons, but one of their benefits is that they remove the dependency on a proprietary hub (e.g. IKEA, Xiaomi, Philips). However, the proprietary hubs not only connect a controller with lights or media players, they also give them behaviour: dimming while a button is held, cycling colors, changing the volume, etc. Without the hub, we end up writing Home Assistant automations, and automations like these quickly get tricky and difficult to maintain.
This is where ControllerX comes in, together with AppDaemon. It brings back the behaviour that the devices lose without the original hub, and makes it easy to create automations focused on button events.
How it works
flowchart LR
A["Controller<br>(button pressed)"] --> B["Integration<br>(Zigbee2MQTT, ZHA, deCONZ...)"]
B -- "action event<br>e.g. brightness_up_hold" --> C["ControllerX<br>(AppDaemon app)"]
C -- "mapping<br>e.g. hold_brightness_up" --> D["Home Assistant<br>service calls"]
D --> E["Light, media player,<br>switch or cover"]
- When a button is pressed, the integration fires an action event (e.g.
brightness_up_hold). - ControllerX translates that event into a predefined action (e.g.
hold_brightness_up) using the default mapping of the device, or your own custom mapping. - ControllerX calls the Home Assistant services to change the entity. When a button is held, it keeps calling them periodically until the release event arrives, so the brightness, color or volume changes smoothly.
Quick example
With just this configuration placed in your apps.yaml, you can have the E2002 controller from IKEA (4 buttons) connected to the living room light, and be able to change the brightness and the color temperature or color.
livingroom_controller:
module: controllerx
class: E2002LightController
controller: livingroom_controller
integration:
name: z2m
listen_to: mqtt
light: light.livingroom
Using an AI assistant?
This documentation is available in a format that AI assistants can read: llms.txt (index) and llms-full.txt (all the pages in one file). The list of supported devices is available as JSON.
Video examples
- E1810 (IKEA) controlling a light through MQTT
- Symfonisk controlling Chromecast volume
- Magic Xiaomi Cube controlling a colour light
- E1810 (IKEA) controlling a colour light with ZHA
- Symfonisk controlling Google Home mini
- Symfonisk controlling a light
- Showing the colour wheel from HA
- E1743 (IKEA) button as a cover controller
- E1810 (IKEA) as a TV remote
- Double click for the middle button for E1810 (IKEA)
Community
Thank you to all these people for sharing content related to ControllerX:
- /u/canaletto - canaletto.fr (French)
- /u/jones - jbetzen.net (German)
- /u/fribse - YouTube (Danish)
Questions can be asked in the following channels: