Skip to content

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"]
  1. When a button is pressed, the integration fires an action event (e.g. brightness_up_hold).
  2. 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.
  3. 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

Community

Thank you to all these people for sharing content related to ControllerX:

Questions can be asked in the following channels: