Skip to content

Latest commit

 

History

History
109 lines (86 loc) · 2.85 KB

README.md

File metadata and controls

109 lines (86 loc) · 2.85 KB

Modified version of pyShelly to suppor offset cover feature.

founder-wip buy me a coffee

stability-wip PyPI

pyShelly

Library for Shelly smart home devices. Using CoAP for auto discovery and status updates.

This library was created for Shelly Plugins for Home Assistant and Telldus Tellstick Net/zNet v2.

Features

  • Discover devices
  • Monitor status
  • Monitor switch status
  • Control (turn on/off etc)
  • MQTT Server (buildin MQTT server taht devices can connect to directly)
  • MQTT Client (using a MQTT broker)
  • Websocket
  • Run only locally
  • Support user name and password
  • Coexist with Shelly Cloud and Shelly app
  • Support static and dynamic ip address
  • mDns and MQTT discovery
  • RPC (gen 2 devices)
  • Cloud support (Get names of devices etc)

Devices supported

Gen 1 devices

  • Shelly 1
  • Shelly 1 PM (bug in firmware)
  • Shelly 1L
  • Shelly Addon for 1/1PM, temp and humidity
  • Shelly 2 (relay or roller mode)
  • Shelly 4 Pro
  • Shelly Plug
  • Shelly Plug S
  • Shelly BULB
  • Shelly RGBWW
  • Shelly RGBW2
  • Shelly H&T
  • Shelly EM
  • Shelly 2.5 (relay or roller mode)
  • Shelly 2LED
  • Shelly Flood
  • Shelly Door/Window
  • Shelly Door/Window 2
  • Shelly Dimmer
  • Shelly Dimmer 2
  • Shelly EM
  • Shelly 3EM
  • Shelly DUO
  • Shelly Vintage
  • Shelly i3
  • Shelly Button 1
  • Shelly Gas
  • Shelly Air (not tested)

Plus devices

  • Shelly Plus 1
  • Shelly Plus 1PM
  • Shelly Plus 2
  • Shelly Plus 2PM
  • Shelly Plus i3

Pro devices

  • Shelly Pro 1
  • Shelly Pro 1PM
  • Shelly Pro 2
  • Shelly Pro 2PM
  • Shelly Pro 4PM

Comming soon

  • Shelly TRV
  • Shelly Plus H&T

Usage

from pyShelly import pyShelly

def device_added(dev,code):
  print (dev," ",code)

shelly = pyShelly()
print("version:",shelly.version())

shelly.cb_device_added.append(device_added)
shelly.start()
shelly.discover()

while True:
    pass 

Feedback

Please give us feedback on [email protected] or Facebook groups: Shelly grupp (Swedish) or Shelly support group (English)

Founder

This plugin is created by the StyraHem.se, the Swedish distributor of Shelly. In Sweden you can buy Shellies from StyraHem.se or any of the retailers like NetOnNet, Kjell&Company etc.

buy me a coffee