Retrieve all KEY codes from the Sofabaton X2 hub

With the Sofabaton X2 integration, any command the X2 hub knows about can be triggered from Home Assistant.
Using the remote entity the integration adds for each configured hub, commands can be called like this:

    action: remote.send_command
    target:
      entity_id: remote.HUB_NAME
    data:
      command:
        - type: KEY_TYPE
        - activity_id: ACTIVITY_ID
        - key_id: KEY_ID

Automations, scripts and UIs looking to implement this will need KEY_TYPE, ACTIVITY_ID and KEY_ID for each command they intend to trigger. As of January 2026, there is no straight forward way of retrieving this data with the X2 integration.

This blueprint fetches all of these for your Activities and/or Devices, and provides ready to use YAML showing how to use the codes retrieved.

You must have the Sofabaton X2 integration installed and working before running the script.

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

More information is available on Github.

Please feel free to reach out with your questions and comments.

Stay well.

2 Likes