Skip to main content

Controller - IKEA E2001/E2002 STYRBAR Remote control

Import this blueprint

My Home Assistant

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.


tip

This blueprint is part of the Controllers-Hooks Ecosystem. You can read more about this topic here.

Description​

This blueprint provides universal support for running any custom action when a button is pressed on the provided IKEA E2001/E2002 STYRBAR Remote control. Supports controllers integrated with Zigbee2MQTT, ZHA, deCONZ. The blueprint will automagically detect the integration type and take care of all the rest.

In addition of being able to provide custom actions for every kind of button press supported by the remote, the blueprint allows to loop the long press actions while the corresponding button is being held. Once released, the loop stops. This is useful when holding down a button should result in a continuous action (such as lowering the volume of a media player, or controlling a light brightness).

The blueprint also adds support for virtual double button press events, which are not exposed by the controller device itself. However, It needs to be enabled in the blueprint.

tip

Automations created with this blueprint can be connected with one or more Hooks supported by this controller. Hooks allow to easily create controller-based automations for interacting with lights, media players, covers and maybe more in the future. See the list of Hooks available for this controller for additional details.

Requirements​

Zigbee2MQTT Integration

Optional

If you plan to integrate the with Zigbee2MQTT, you must have this integration set up. Installation methods differ between different installation types. Check out the documentation for full details on the required hardware and how to set up Zigbee2MQTT on your system.

Zigbee2MQTT Docs

ZHA Integration

Optional

If you plan to integrate the with ZHA, you must have this integration set up. The ZHA integration can be configured from the Home Assistant UI. Check the documentation for full details on the required hardware and how to set up ZHA on your system.

ZHA Integration Docs

deCONZ Integration

Optional

If you plan to integrate the with deCONZ, you must have this integration set up. The deCONZ integration can be configured from the Home Assistant UI and requires an additional container to run deCONZ on. Head over to the documentation for full details on the required hardware and how to set up deCONZ on your system.

deCONZ Integration Docs

Inputs​

Available Hooks​

Virtual double press actions

Some of the following mappings might include actions for virtual double press events, which are disabled by default. If you are using a hook mapping which provides an action for a virtual double press event, please make sure to enable support for virtual double press on the corresponding buttons with the corresponding blueprint input.

Light​

This Hook blueprint allows to build a controller-based automation to control a light. Supports brightness and color control both for white temperature and rgb lights.

(Default) Mapping​

  • Up button short press -> Turn on
  • Up button long press -> Brightness up (continuous, until release)
  • Down button short press -> Turn off
  • Down button long press -> Brightness down (continuous, until release)
  • Left button short press -> Color down
  • Left button long press -> Color down (continuous, until release)
  • Right button short press -> Color up
  • Right button long press -> Color up (continuous, until release)

(Option 1) Mapping​

  • Up button short press -> Brightness up
  • Up button long press -> Brightness up (continuous, until release)
  • Up button double press Virtual -> Turn on
  • Down button short press -> Brightness down
  • Down button long press -> Brightness down (continuous, until release)
  • Down button double press Virtual -> Turn off
  • Left button short press -> Color down
  • Left button long press -> Color down (continuous, until release)
  • Right button short press -> Color up
  • Right button long press -> Color up (continuous, until release)

Light Hook docs

Media Player​

This Hook blueprint allows to build a controller-based automation to control a media player. Supports volume setting, play/pause and track selection.

(Default) Mapping​

  • Up button short press -> Play/Pause
  • Up button long press -> Volume up (continuous, until release)
  • Down button short press -> Stop
  • Down button long press -> Volume down (continuous, until release)
  • Left button short press -> Previous track
  • Right button short press -> Next track

Media Player Hook docs

Cover​

This Hook blueprint allows to build a controller-based automation to control a cover. Supports opening, closing and tilting the cover.

(Default) Mapping​

  • Up button short press -> Open cover
  • Up button long press -> Open the cover tilt
  • Up button double press Virtual -> Stop cover and cover tilt
  • Down button short press -> Close cover
  • Down button long press -> Close the cover tilt
  • Down button double press Virtual -> Stop

Cover Hook docs

Additional Notes​

Virtual double press events​

It's important to note that the controller doesn't natively support double press events. Instead , this blueprint provides virtual double press events. You can read more about them in the general Controllers-Hooks Ecosystem documentation.

Changelog​

  • 2021-11-07: first blueprint version 🎉

  • 2022-08-08: Optimize characters usage for the helper_last_controller_event text input.

  • 2025-01-02:

    • (ZHA) Fixed a bug preventing long pressing actions to be triggered. (@Ivarvdb)
    • (Zigbee2MQTT) handle "unknown" state. (@beardhatcode)

  • 2025-01-03: Remove spaces to match new helper format in Home Assistant 2023.5.x. (@LordSushiPhoenix)

  • 2025-02-13:

    ⚠️ Breaking Change:

    Migrate to Zigbee2MQTT MQTT Device Triggers. (@yarafie)

    The controller_entity input has been deprecated, and controller_device is now mandatory. If you are a Zigbee2MQTT user and plan to update this blueprint, please make sure to remove the controller_entity input from your automation config and add the device ID of your controller to the controller_device input. To obtain the device ID from your controller, configure the automation from the UI and use the device selector dropdown on the controller_device input to select your controller.

  • 2025-03-20: Standardized input naming format for controller devices and virtual button actions. No functionality changes.

  • 2025-04-01: Fix double-click detection logic. (@danleongjy)

  • 2025-04-16: Fix Long Press Down not releasing (@kkthxbye-code)

  • 2025-04-19: Improve Last Controller Event Helper JSON Regex with more lenient matching.

  • 2025-10-05: STYRBAR (Z2M) – include additional common variants. (@yarafie)