Shelly Bulbs Gen3 can be controlled locally via your Wi-Fi/LAN using direct HTTP commands.
This is useful when you want one Shelly device, automation, browser, local script, or third-party system to control a Shelly Bulb directly, without depending on cloud execution.
This type of control is often referred to as Direct Device-to-Device communication, or DDD.
TABLE OF CONTENTS
- Before you start
- Shelly Multicolor Bulb Gen3
- Shelly Standard Bulb Gen3
- Quick command reference
- Troubleshooting
------------------------------------------------------------------------------------------------------------------------------
Before you start
Make sure the device sending the command and the Shelly Bulb are connected to the same local network.
You also need to know the local IP address of the bulb.
In the examples below, replace:
192.168.X.X
with the actual IP address of your Shelly Bulb.
Example:
http://192.168.1.82/...
------------------------------------------------------------------------------------------------------------------------------
Shelly Multicolor Bulb Gen3
Shelly Multicolor Bulb Gen3 uses the RGBCCT component.
This means the bulb supports both:
RGB color control for colored light
CCT control for white light with adjustable color temperature
The local direct endpoint is:
http://192.168.X.X/rgbcct/0?...
Turn the bulb on:
http://192.168.X.X/rgbcct/0?turn=on
Turn the bulb off:
http://192.168.X.X/rgbcct/0?turn=off
Toggle the bulb:
http://192.168.X.X/rgbcct/0?turn=toggle
Turn on at 50% brightness:
http://192.168.X.X/rgbcct/0?turn=on&brightness=50
Brightness is set from 0 to 100.
Example values:
10 = very dim
50 = medium brightness
100 = full brightness
#For Shelly Bulbs Gen3, use the new rgbcct endpoint instead of the old /color/0 command!
#New Shelly Multicolor Bulb Gen3 command:
http://192.168.X.X/rgbcct/0?turn=on&red=255&green=86&blue=112&brightness=100
The values are:
red from 0 to 255
green from 0 to 255
blue from 0 to 255
brightness from 0 to 100
*The old white=0 parameter is not needed in the new format.*
The same Multicolor Bulb can also be used as a white-temperature bulb.
Neutral white example:
http://192.168.X.X/rgbcct/0?turn=on&brightness=100&temp=4000
The temp value is the color temperature in Kelvin.
Typical values:
2700 = warm white
4000 = neutral white
6500 = cold white
Use transition effects
http://192.168.X.X/rgbcct/0?turn=on&red=255&green=86&blue=112&brightness=100&transition=1000
The transition value is in milliseconds.
1000 = 1 second
3000 = 3 seconds
5000 = 5 seconds
------------------------------------------------------------------------------------------------------------------------------
Shelly Standard Bulb Gen3
Shelly Standard Bulb Gen3 uses the CCT component.
This means it controls white light only, with adjustable brightness and color temperature.
The local direct endpoint is:
http://192.168.X.X/cct/0?...
Turn the bulb on:
http://192.168.X.X/cct/0?turn=on
Turn the bulb off:
http://192.168.X.X/cct/0?turn=off
Toggle the bulb:
http://192.168.X.X/cct/0?turn=toggle
Turn on at 50% brightness:
http://192.168.X.X/cct/0?turn=on&brightness=50
Brightness is set from 0 to 100.
Set white color temperature:
Neutral white example:
http://192.168.X.X/cct/0?turn=on&brightness=100&temp=4000
The temp value is the color temperature in Kelvin.
Can use transition effects as well.
http://192.168.X.X/cct/0?turn=on&brightness=100&temp=2700&transition=1000
The transition value is in milliseconds.
1000 = 1 second
3000 = 3 seconds
5000 = 5 seconds
------------------------------------------------------------------------------------------------------------------------------
Quick command reference
Multicolor Bulb Gen3:
/rgbcct/0
Standard Bulb Gen3:
/cct/0
Turn on:
turn=on
Turn off:
turn=off
Toggle:
turn=toggle
Brightness:
brightness=0-100
RGB color:
red=0-255&green=0-255&blue=0-255
White temperature:
temp=2700-6500
Transition:
transition=1000
------------------------------------------------------------------------------------------------------------------------------
Troubleshooting
If the command does not work, first open the bulb IP address in your browser and confirm that the bulb web interface is reachable.
Make sure the device sending the command and the bulb are on the same local network.
For Multicolor Bulb Gen3, use /rgbcct/0.
For Standard Bulb Gen3, use /cct/0.
Do not use the old /color/0 endpoint for Shelly Bulbs Gen3.