Skip to main content

Controller - Shelly Button 1

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 Shelly Button 1. Supports controllers integrated with Shelly. 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).

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​

Shelly Integration

Optional

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

Shelly Docs

Inputs​

Available Hooks​

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​

  • Button button short press -> Toggle
  • Button button double press -> Brightness up
  • Button button triple press -> Brightness down
  • Button button long press -> Brightness 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​

  • Button button short press -> Play pause
  • Button button double press -> Next track
  • Button button triple press -> Previous track
  • Button button long press -> Stop

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​

  • Button button short press -> Open cover
  • Button button double press -> Close cover
  • Button button long press -> Stop cover and cover tilt

Cover Hook docs

Additional Notes​

Only supports firmware 1.9 and later installed on Shelly Button 1. Check Home Assistant Shelly Integration for additional details.

Changelog​

  • 2025-04-12: Initial release. (@yarafie) 🎉