Product
Socket Now Supports uv.lock Files
Socket now supports uv.lock files to ensure consistent, secure dependency resolution for Python projects and enhance supply chain security.
By Trevor Norris - Jan 09, 2025
Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →
iobroker.shelly
Advanced tools
ioBroker.shelly
Requires node.js 8.0 or higher and Admin v3!
The adapter communicates with Shelly devices by REST api and the CoAP or MQTT protocol.
By the default Shelly firmware (no flashing of firmware needed!). You will find more and detailed information about the device here : Shelly
This adapter uses Sentry libraries to automatically report exceptions and code errors to me as the developer. More details see below!
Installation
You find a detailed installation documentation here: Installation Documentation
Supported devices
| Shelly Device | Default (CoAP) | MQTT |
|---|---|---|
| Shelly1 (SHSW-1) | verified | verified |
| Shelly2 (SHSW-21/SHSW-22) | verified | verified |
| ShellyBulb (SHBLB) | verified | verified |
| Shelly H&T (SHHT-1) | verified | verified |
| Shelly Smoke (SHSM-01) | verified | verified |
| Shelly 1 1PM (SHSW-PM) | verified | verified |
| Shelly 2.5 (SHSW-25) | verified | verified |
| ShellyRGBW (SHRGBWW-01) | verified | verified |
| ShellyRGBW2 (SHRGBW2) | verified | verified |
| Shelly2LED (SH2LED) | verified | verified |
| ShellyPlug (SHPLG-1) | verified | verified |
| ShellyPlug S (SHPLG-1) | verified | verified |
| ShellyPlug 2 (SHPLG-2) | verified | verified |
| ShellySense (SHSEN-1) | verified | not verified |
| Shelly4Pro (SHSW-44) | verified | not verified |
| Shelly EM (SHEM) | verified | verified |
| Shelly Flood (SHWT-1) | verified | verified |
| Shelly Dimmer (SHDM-1) | verified | verified |
| Shelly Door/Window Sensor (SHDW-1) | verified | verified |
| Shelly Bulb Duo (SHBDUO-1) | verified | not verified |
| Shelly 3EM (SHEM) | verified | verified |
What is Sentry and what is reported to the servers?
Sentry.io is a way for developers to get an overview about errors from their applications. And exactly this is implemented in this adapter.
When the adapter crashes or an other Code error happens, this error message that also appears in the ioBroker log is submitted to our own Sentry server hosted in germany. When you allowed iobroker GmbH to collect diagnostic data then also your installation ID (this is just a unique ID without any additional infos about you, email, name or such) is included. This allows Sentry to group errors and show how many unique users are affected by such an error. All of this helps me to provide error free adapters that basically never crashs.
Changelog
3.2.7 (28.04.2020)
- (Stübi) - User can enable/disable sentry logging
3.2.6 (27.04.2020)
- (Apollon77) - Update Dependencies incl shelly-lib to prevent exceptions
- (Apollon77) - Add Sentry for error/crash reporting (active with js-controller 3.0)
- (Stübi - Add for hue two new datapoints for Shelly Bulb and RGBW2
- (@SamLowrie) - Add option to set a specific multicast interface for CoAP server
3.2.4 (11.04.2020)
- (Stübi) - Bugfixing MQTT ext_temperature for Shelly 1
3.2.3 (03.03.2020)
- (Stübi) - Bugfixing Shelly 3EMfor MQTT support (fixed datapoints for total and total_returned)
- (Stübi) - Bugfixing MQTT support for door and windows sensor (issue #135)
3.2.2 (03.03.2020)
- (Stübi) - Bugfixing, if Shelly sends a string instead of number and boolean (issue #131)
3.2.1 (02.03.2020)
- (Stübi) - Bugfixing Shelly 3EMfor MQTT support
3.2.0 (13.02.2020)
- (Simon W.) - Add device Shelly 3EM
- (Stübi) - Add device Shelly Door/Windows sensor
- (Stübi) - Add external temperature sensor for Shelly 1, 1PM and 2.5 (only CoAP)
3.1.9 (25.01.2020)
- (Stübi) - Bugfixing, auto update new firmware
3.1.7 (08.01.2020)
- (Stübi) - Add state energy to Shelly dimmer
3.1.6 (30.12.2019)
- (Stübi) - Add device Shelly Door/Windows sensor
- (Stübi) - Bugfixing, auto update new firmware
3.1.5 (23.12.2019)
- (Stübi) - Add device Shelly Plug S2. It will be shown as Shelly Plug S (SHPLG-1) in MQTT
3.1.4 (11.12.2019)
- (Stübi) - Bugfixing, auto update new firmware
3.1.3 (07.12.2019)
- (Stübi) - Bugfixing. Add power state to Shelly dimmer in MQTT mode
3.1.2 (11.10.2019)
- (Stübi) - Bugfixing. Error message will not only be shown in debug modus
3.1.1 (14.09.2019)
- (Stübi) - Add device Shelly Dimmer
3.1.0 (03.09.2019)
- (Stübi) - Add device Shelly flood
3.0.9 (06.08.2019)
- (Stübi) - Bugfixing, with the new firmware, Shelly HT sends the humidity by CoAP as it should. Division by 2 removed!
- (Stübi) - Add status Duration in roller (shutter) mode for CoAP (not working with MQTT)
- (Stübi) - Changed role from level to level.brightness for state Gain
3.0.8 (27.07.2019)
- (Stübi) - Add device Shelly EM
- (Stübi) - Add state energy for Shelly Plug S, Shelly PM and Shelly 2.5 in CoAP mode
- (Stübi) - Add state temperature for Shelly Plug S, Shelly PM and Shelly 2.5 in CoAP mode
- (Stübi) - Add state overtemperature for Shelly Plug S, Shelly PM and Shelly 2.5 in CoAP and MQTT mode
- (Stübi) - Bugfixing, the Shelly HT sends by CoAP the humidity multiply with 2. The fix divides the value by 2.
3.0.7 (03.07.2019)
- (Stübi) - correct spelling error
- (Stübi) - Adjust IP address after IP change in CoAP Modus (Issue 70)
- (Stübi) - Bugfixing for datapoint power (rounding method was wrong)
- (Stübi) - Fixed Buffer() is deprecated due to security and usability issues for Node >= 10
3.0.6 (29.06.2019)
- (Stübi) - State reboot and uptime added
3.0.5 (16.06.2019)
- (Stübi) - Bugfixing
- (Stübi) - Add Blacklist
3.0.4 (04.06.2019)
- (Stübi) - Bugfixing (Issue #60)
3.0.3 (02.06.2019)
- (Stübi) - Support of MQTT QoS 1 and 2. Add auto firmware update to the menu
3.0.2 (25.05.2019)
- (Stübi) - Bugfixing and longpush and input states for Shelly 1, 2, 1pm, 2.5 and Shelly RGBWW2 added. Add state temperature to Shelly 1pm, 2.5 and Plug S.
3.0.1 (21.05.2019)
- (Stübi) - Redesign of the adapter. You can choose now between CoAP and MQTT protocol. The Shellys use this protocolls to send there state changes to ioBroker in realtime. Out of the Box the Shelly works with the CoAP protocol. You do not have to configure anything. The Shelly will be found by the Shelly Adapter itself. If you want to use MQTT, you have configure all your Shelly devices. You find a detailed installing documentation here: Installation Documentation. If you have problems with the version 3.0.1 please change back to 2.2.0 and leave an Issue (bug report) here: GitHub Issues.
2.2.0 (13.04.2019)
- Add devices Shelly 2.5 and Shelly 1 PM
2.1.9 (31.03.2019)
- Add status 'firmware update' for Shelly RGBW, RGBW2 and Bulb
2.1.8 (19.03.2019)
- Consider roller (shutter) position in CoAP message
- Support of Shelly Sensor
2.1.7 (15.03.2019)
- Changing all RGBWW2 colors at the same time
- new RGBWW2 State color.rgbw with the format #RRGGBBWW
2.1.6 (08.03.2019)
- Shelly RGBWW2 bug fixing (whit did not work in color mode)
2.1.5 (05.03.2019)
- Shelly Smoke Support
2.1.4 (20.02.2019)
- Bugfixing of Shelly RGBW2 Support. If you have installed version 2.1.3, please delete all RGBW2 objects first, because the objects will be renamed from lights to color and white in version 2.1.4.
2.1.3 (16.02.2019)
- Support of Shelly RGBW2
2.1.0 (09.02.2019)
- New Status 'new firmware available' for Shely1, Shelly2, Shelly4Pro and ShellyPlug
2.0.8 (31.01.2019)
- Bugfixing, polling new Shelly status must be at least 1 sec ago
2.0.7 (21.01.2019)
- Bugfixing for objects AutoTimerOn and AutoTimeroff
2.0.6 (12.01.2019)
- Getting faster online status for Shelly devices, excluded H&T. Fix of power status for Shelly Plug.
2.0.5 (07.01.2019)
- Fixing an error if Shelly device is not reachable (offline)
2.0.4 (04.01.2018)
- Support of js-controller compact mode and performance optimizing. Relay status changes will be shown much faster in ioBroker for Shelly 1, 2 and 4Pro
2.0.3 (02.01.2018)
- Shows RSSI Status for Shelly 1 & 2. You need Firmware 1.4.4
License
The MIT License (MIT)
Copyright (c) 2018-2020 Thorsten Stueben thorsten@stueben.de, Apollon77 iobroker@fischer-ka.de
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Keywords
FAQs
Integrate your Shelly devices into ioBroker via MQTT or CoAP
The npm package iobroker.shelly receives a total of 4,556 weekly downloads. As such, iobroker.shelly popularity was classified as popular.
We found that iobroker.shelly demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Package last updated on 03 May 2020
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Research
Security News
Gmail For Exfiltration: Malicious npm Packages Target Solana Private Keys and Drain Victims' Wallets
Socket researchers have discovered multiple malicious npm packages targeting Solana private keys, abusing Gmail to exfiltrate the data and drain Solana wallets.
By Kirill Boychenko - Jan 08, 2025
Security News
New Python Packaging Proposal Aims to Solve Phantom Dependency Problem with SBOMs
PEP 770 proposes adding SBOM support to Python packages to improve transparency and catch hidden non-Python dependencies that security tools often miss.
By Sarah Gooding - Jan 07, 2025