Shelly Easy Smart Home Automation

SHELLY: The go-to access control for smart homes.

This Python library provides convenient access to the Shelly cloud API, allowing you to manage your relays, rollers and lights.

Shelly Shop
Request Feature/Suggestion: https://forms.gle/efGD5DuTpWsX96GG7

Download stats

Installation

pip install shelly_control

Shelly supports Python 3+.

Usage

Default

import shelly_control

Authentication

Before making requests, you need to authenticate using your Shelly API key. Initialize the Connect class with your API key:

from shelly_control import Connect

base_url = "Your Cloud Server Address"
api_key = "Your Authorization cloud key"
sh = Connect(base_url,api_key)

OR

import shelly_control 

base_url = "Your Cloud Server Address"
api_key = "Your Authorization cloud key"
sh = shelly_control.Connect(base_url,api_key)

Get Key & Server address from here Shelly Control Cloud Dashboard

Relay

Fetch Devices

# Fetch device status
sh.get_device('device_id')

Control Devices

# Control device
sh.control_device(channel , 'on'/'off' , device_id)

Bulk Control Devices

# Bulk Control device
sh.bulk_control_relays('devices')

# Parameters:
#        - devices (list of dict): List of devices to control, each device should be a dictionary with keys:
#            - "id" (int): ID of the device.
#            - "channel" (int): Index of the relay or switch component.

Rollers

Control Roller Direction

# Control Roller
sh.control_roller_direction(direction , device_id)

Control Roller Position

# Control Roller
sh.control_roller_position(position , device_id)

Bulk Control Roller

# Bulk Control Roller
sh.bulk_control_rollers(device_id)

Lights

Control Lights

# Bulk Control Roller
sh.control_light(turn=None , white=None , red=None , green=None , blue=None , gain=None , device_id=None)