A custom Home Assistant integration that turns the built-in RGB LED ring of your Shelly Plug S (Gen2 / Gen3) devices into an independent, fully controllable smart light entity.
This integration interacts with the LED configuration engine. It allows you to
- change colors
- apply dimming levels
- toggle the ring on and off
without affecting the operational on/off power state of the actual smart plug relay.
- You must have your Shelly plugs already configured and active in Home Assistant via the official built-in Shelly integration.
- Your hardware must be Generation 2 or Generation 3 local RPC devices (such as the standard Shelly Plus Plug S or newer variants).
- Open HACS in your Home Assistant sidebar.
- Click the three dots
...in the top-right corner and select Custom repositories. - Paste the URL of your GitHub repository into the Repository input.
- Select Integration as the Category and click Add.
- Find Shelly Plug LED Ring in the HACS interface and click Download.
- Restart Home Assistant Core to load the custom workspace files.
- Download the project repository source archive.
- Extract the archive and copy the folder
config/custom_components/shelly_plug_leddirectly into your Home Assistant runtime directory. - Restart Home Assistant Core.
- In Home Assistant, navigate to Settings > Devices & Services.
- Click the Add Integration button in the bottom right corner.
- Search for Shelly Plug LED Ring and select it.