IKEA BILRESA Scroll Wheel - 3 Light Presets

Manual import URL: https://github.com/0libote/HA-BPs/blob/main/blueprints/bilresa-scroll-wheel.yaml

Setup guide

https://github.com/0libote/HA-BPs/blob/main/blueprints/bilresa-scroll-wheel.yaml

Input reference

Every field, default and selector — generated from the YAML at build time.

Source

Full blueprint — also on GitHub.

blueprint:
  name: IKEA BILRESA Scroll Wheel - 3 Light Presets
  author: 0libote
  description: |
    Flexible light control for the IKEA BILRESA scroll wheel remote via Matter.

    Created by @0libote
    GitHub: https://github.com/0libote/HA-BPs

    Setup is top-down: pick the 9 remote event entities, pick the lights for
    each preset, then tune the shared wheel and colour feel once.

    Each of the three physical BILRESA presets can:
    - Control its own set of lights.
    - Be disabled.
    - Duplicate another preset's lights and colours.
    - Share one brightness step, range and transition.
    - Share one centre-button layout (Tap = Colour / Hold = Power, or reversed).
    - Use its own ordered colour list with Home Assistant's RGB colour picker.
    - Reorder colours by dragging them in the blueprint editor.

    Presets 2 and 3 duplicate Preset 1 by default, so a single room works after
    configuring Preset 1 only. Switch a preset to a custom profile when it
    should control different lights or cycle different colours.

    Wheel movement uses Matter's totalNumberOfPressesCounted value, so a quick
    multi-detent spin is applied as one larger brightness change. Brightness is
    clamped to the configured minimum and maximum. Scrolling right while the
    preset's lights are off turns them on at the minimum brightness. Tapping
    for colour while off turns them on with the first colour.

    Updating from an older version resets per-preset tuning to the new shared
    Wheel and Colour settings. Re-check those once after updating.

    Important Matter limitation:
    If the BILRESA itself aborts an over-limit multi-press sequence and sends no
    completed event, a blueprint cannot recover that missing movement.

  domain: automation
  source_url: https://github.com/0libote/HA-BPs/blob/main/blueprints/bilresa-scroll-wheel.yaml

  homeassistant:
    min_version: 2025.7.0

  input:

    # ============================================================
    # REMOTE
    # ============================================================
    remote:
      name: Remote buttons
      icon: mdi:remote
      collapsed: false
      description: |
        The 9 BILRESA event entities, three per physical preset. On the device
        page, identify right/brighter, left/dimmer and centre push for each
        preset and confirm they update when the control is used.
      input:

        button_1:
          name: Preset 1 - Right / Brighter
          description: Preset 1 scroll-right event entity.
          default: event.bilresa_unused_preset_1_button_1
          selector:
            entity:
              filter:
                - domain: event

        button_2:
          name: Preset 1 - Left / Dimmer
          description: Preset 1 scroll-left event entity.
          default: event.bilresa_unused_preset_1_button_2
          selector:
            entity:
              filter:
                - domain: event

        button_3:
          name: Preset 1 - Centre Push
          description: Preset 1 centre/push event entity.
          default: event.bilresa_unused_preset_1_button_3
          selector:
            entity:
              filter:
                - domain: event

        button_4:
          name: Preset 2 - Right / Brighter
          description: Preset 2 scroll-right event entity.
          default: event.bilresa_unused_preset_2_button_4
          selector:
            entity:
              filter:
                - domain: event

        button_5:
          name: Preset 2 - Left / Dimmer
          description: Preset 2 scroll-left event entity.
          default: event.bilresa_unused_preset_2_button_5
          selector:
            entity:
              filter:
                - domain: event

        button_6:
          name: Preset 2 - Centre Push
          description: Preset 2 centre/push event entity.
          default: event.bilresa_unused_preset_2_button_6
          selector:
            entity:
              filter:
                - domain: event

        button_7:
          name: Preset 3 - Right / Brighter
          description: Preset 3 scroll-right event entity.
          default: event.bilresa_unused_preset_3_button_7
          selector:
            entity:
              filter:
                - domain: event

        button_8:
          name: Preset 3 - Left / Dimmer
          description: Preset 3 scroll-left event entity.
          default: event.bilresa_unused_preset_3_button_8
          selector:
            entity:
              filter:
                - domain: event

        button_9:
          name: Preset 3 - Centre Push
          description: Preset 3 centre/push event entity.
          default: event.bilresa_unused_preset_3_button_9
          selector:
            entity:
              filter:
                - domain: event

    # ============================================================
    # LIGHTS
    # ============================================================
    lights:
      name: Lights and presets
      icon: mdi:lightbulb-group
      collapsed: false
      description: |
        Pick which lights each preset controls. Duplicating reuses that
        preset's lights and colour list. Disabled presets do nothing.
      input:

        preset_1_mode:
          name: Preset 1 Mode
          default: custom
          selector:
            select:
              mode: dropdown
              options:
                - label: Custom profile
                  value: custom
                - label: Disabled
                  value: disabled

        preset_1_lights:
          name: Preset 1 Lights
          description: Lights controlled by this preset. Ignored when disabled.
          default: []
          selector:
            entity:
              multiple: true
              filter:
                - domain: light

        preset_2_mode:
          name: Preset 2 Mode
          default: duplicate_preset_1
          selector:
            sel
… (truncated — see GitHub for full file)