Shelly Smart Home Control Software

Control for Shelly smart home devices. Auto-detects Gen1 (HTTP polling) or Gen2/Gen3 (WebSocket RPC with real-time push feedback). Dimmer, RGB(W) and CCT brightness, colour temperature, colour channels and cover position can be driven from panel faders, rotaries and Stream Deck + dials.
Setup: Enter the device IP. Port defaults to 80. Username/Password only if authentication is enabled in the Shelly app.

Category	Actions
Switch / Relay	switch_on, switch_off, switch_toggle
Light / Dimmer	light_on, light_off, light_toggle, light_brightness, light_color_temp
RGB / LED Strip	rgb_on, rgb_off, rgb_toggle, rgb_set_color, rgb_adjust (hold-to-repeat)
Cover / Roller Shutter	cover_open, cover_close, cover_stop, cover_set_pos
Power Monitoring	reset_energy (Switch PM, PM1, EM, EM1)
System	connect, refresh, reboot

This handler supports all Shelly device families. Gen1 uses HTTP polling; Gen2/Gen3 uses WebSocket RPC for real-time push feedback. Generation and model are auto-detected on connect.

Integration examples — assuming device name "SHELLY_LAMP"

Replace <fantago> with your Fantago IP and <port> with the HTTP port (default 3000).

Switch / Relay

Action	HTTP GET	TCP / UDP
Turn on relay 0	/sendTo/SHELLY_LAMP?cmd=switch_on&id=0	SHELLY_LAMP:switch_on&id=0
Turn off relay 0	/sendTo/SHELLY_LAMP?cmd=switch_off&id=0	SHELLY_LAMP:switch_off&id=0
Toggle relay 1	/sendTo/SHELLY_LAMP?cmd=switch_toggle&id=1	SHELLY_LAMP:switch_toggle&id=1

Light / Dimmer

Action	HTTP GET	TCP / UDP
Turn on light 0	/sendTo/SHELLY_LAMP?cmd=light_on&id=0	SHELLY_LAMP:light_on&id=0
Set brightness 75%	/sendTo/SHELLY_LAMP?cmd=light_brightness&id=0&brightness=75	SHELLY_LAMP:light_brightness&id=0&brightness=75
Set color temp 3200 K	/sendTo/SHELLY_LAMP?cmd=light_color_temp&id=0&temp=3200	SHELLY_LAMP:light_color_temp&id=0&temp=3200

RGB / LED Strip (RGBW2, Plus RGBW PM)

Action	HTTP GET	TCP / UDP
Set color red at full brightness	/sendTo/SHELLY_LAMP?cmd=rgb_set_color&id=0&red=255&green=0&blue=0&white=0&gain=100	SHELLY_LAMP:rgb_set_color&id=0&red=255&green=0&blue=0&white=0&gain=100
Increase red channel by 10	/sendTo/SHELLY_LAMP?cmd=rgb_adjust&id=0&channel=red&delta=10	SHELLY_LAMP:rgb_adjust&id=0&channel=red&delta=10
Decrease brightness by 5	/sendTo/SHELLY_LAMP?cmd=rgb_adjust&id=0&channel=brightness&delta=-5	SHELLY_LAMP:rgb_adjust&id=0&channel=brightness&delta=-5

Cover / Roller shutter

Action	HTTP GET	TCP / UDP
Open cover 0	/sendTo/SHELLY_LAMP?cmd=cover_open&id=0	SHELLY_LAMP:cover_open&id=0
Go to position 40%	/sendTo/SHELLY_LAMP?cmd=cover_set_pos&id=0&pos=40	SHELLY_LAMP:cover_set_pos&id=0&pos=40
Stop	/sendTo/SHELLY_LAMP?cmd=cover_stop&id=0	SHELLY_LAMP:cover_stop&id=0

Power Monitoring & System

Action	HTTP GET	TCP / UDP
Reset energy counter	/sendTo/SHELLY_LAMP?cmd=reset_energy&id=0	SHELLY_LAMP:reset_energy&id=0
Force status refresh	/sendTo/SHELLY_LAMP?cmd=refresh	SHELLY_LAMP:refresh
Reboot device	/sendTo/SHELLY_LAMP?cmd=reboot	SHELLY_LAMP:reboot

Faders, rotaries and Stream Deck + dials

Pick a Position action on a panel fader or rotary, or an Adjust action on a Stream Deck + dial, and choose the light or cover: the builder fills in the position variable, the value text and the marks.

• Brightness — dimmers, RGB, RGBW and CCT lights. 0 turns the light off, any level above turns it on; DEVICE_light_0_level_pos is 0 while the light is off.
• Colour Temperature — CCT lights (Gen2/Gen3), 2700-6500 K: DEVICE_cct_0_ct / _ct_pos.
• Colour Channel — red, green, blue or white of an RGB/RGBW light (0-255): DEVICE_rgbw_0_red / _red_pos. The light's on/off state is left as it is.
• Cover / Roller — the position to go to; DEVICE_cover_0_target_pos is where the cover is going, DEVICE_cover_0_pos where it is.

The connection opens when Fantago starts. While a device does not answer, one warning is logged and the attempts go on quietly (every 5 s, then up to once a minute); a control moved meanwhile is refused with one warning.

Variables written to system panel (replace DEVICE with your device prefix)

Variable	Description
DEVICE_connected	Connection state (true/false)
DEVICE_gen	Detected generation (1, 2 or 3)
DEVICE_model	Device model string
Switch / Relay (Shelly 1, 2.5, Plug S, Plus 1PM, Pro 4PM…)
DEVICE_switch_0_output	Relay state (true/false)
DEVICE_switch_0_apower	Active power in W
DEVICE_switch_0_voltage	Voltage in V
DEVICE_switch_0_current	Current in A
DEVICE_switch_0_pf	Power factor (Gen2)
DEVICE_switch_0_freq	Frequency in Hz (Gen2)
DEVICE_switch_0_energy	Total energy in Wh
Light / Dimmer (Shelly Dimmer, Bulb, Duo…)
DEVICE_light_0_output	Light state (true/false)
DEVICE_light_0_brightness	Brightness 0–100
DEVICE_light_0_ct	Color temperature in K (Gen2) or 0–100 (Gen1)
RGB / LED (Shelly RGBW2, Plus RGBW PM…)
DEVICE_rgb_0_output	RGB output state (true/false)
DEVICE_rgb_0_red / _green / _blue	Color channels 0–255
DEVICE_rgb_0_brightness	Master brightness 0–100
DEVICE_rgbw_0_white	White channel 0–255 (RGBW devices only)
Cover / Roller (Shelly 2.5 in roller mode, Plus 2PM…)
DEVICE_cover_0_state	open / closed / opening / closing / stopped
DEVICE_cover_0_pos	Position 0–100 %
Power meters (Shelly PM Mini, Pro PM, Pro EM-50)
DEVICE_pm1_0_apower	Active power in W
DEVICE_pm1_0_voltage / _current / _pf / _freq / _appower / _energy	Full PM data
3-phase energy meter (Shelly Pro 3EM)
DEVICE_em_0_a_apower / _b_apower / _c_apower	Active power per phase in W
DEVICE_em_0_a_voltage / _b_voltage / _c_voltage	Voltage per phase in V
DEVICE_em_0_a_pf / _b_pf / _c_pf	Power factor per phase
DEVICE_em_0_total_apower	Total active power W (all 3 phases)
DEVICE_em_0_energy / _energy_returned	Total energy / returned energy in Wh (solar)
Sensors
DEVICE_input_0_state	Digital input state (true/false)
DEVICE_temperature_0_tc	Temperature in °C
DEVICE_humidity_0_rh	Humidity in %

Note: Use channel index (0, 1, 2…) for multi-channel devices. The id parameter defaults to 0 if omitted.