summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJan200101 <sentrycraft123@gmail.com>2019-09-23 12:53:55 +0200
committerJan200101 <sentrycraft123@gmail.com>2019-09-23 12:53:55 +0200
commit000383012f3b14f2e47f37a58b86c4a2cc30ad7e (patch)
tree96146672755987f59d1bb68c67715646e952def5
parent0ee8035668b5a2a2bdfe42508efba15bafb4b42c (diff)
downloadShellyPy-000383012f3b14f2e47f37a58b86c4a2cc30ad7e.tar.gz
ShellyPy-000383012f3b14f2e47f37a58b86c4a2cc30ad7e.zip
update README
-rw-r--r--README.md46
1 files changed, 45 insertions, 1 deletions
diff --git a/README.md b/README.md
index 13bd9cc..b78c2d1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,47 @@
# ShellyPy
not to be confused with [pyShelly](https://github.com/StyraHem/pyShelly)
-Wrapper around the Shelly HTTP api
+Python 2 and 3 Wrapper around the Shelly HTTP api
+
+
+## why
+other packages like [pyShelly](https://github.com/StyraHem/pyShelly) only support CoAP or MSQT, neither I am comfortable with using in something
+
+
+## example
+here is a simple working example for the Shelly 1 that turns on whatever is hooked up to it
+```python
+import ShellyPy
+
+device = ShellyPy.Shelly("192.168.0.5")
+
+device.relay(0, turn=True)
+```
+this example with comments can be found on [examples/toggle_lights.py](examples/toggle_lights.py)
+
+## devices
+#### supported
+- Shelly1
+- Shelly1PM
+- Shelly2
+- Shelly2.5 (untested)
+- Shelly4Pro (untested)
+- Shelly Plug (untested)
+- Shelly PlugS (untested)
+- Shelly Bulb (untested)
+- Shelly H&T (untested)
+- Shelly Smoke (untested)
+- Shelly EM (untested)
+- Shelly flood (untested)
+
+#### unsupported
+- Shelly Sense (documentation is inaccurate, incomplete)
+- Shelly RGBW (documentation is incomplete)
+
+## applicability
+this wrapper is best used in closed networks where other solutions are either not an option or not desired
+give your shelly devices static IP adresses for best results
+
+
+## license
+this project is licensed under the [MIT License](LICENSE)
+feel free to do whatever you want with it \ No newline at end of file