StarRankExplorer
Back to rankings

mongoose-os-apps/shelly-homekit

C++

Apple HomeKit firmware for Shelly's

firmwarehomekitshellysmarthome
Star Growth
Stars
2k
Forks
149
Weekly Growth
—
Issues
41
1k2k
Feb 2020Mar 2022May 2024Jul 2026
README

License Gitter

Open Source Apple HomeKit Firmware for Shelly Devices

This firmware exposes Shelly devices as Apple HomeKit accessories.

Firmware is compatible with stock and can be uploaded via OTA (Watch a 2 minute video), for more info take a look at the flashing wiki here.

Reverting to stock firmware is also possible see here.

Supported devices and features

Gen 3 Devices

1 G3 1PM G3 2PM G3 I4 G3 Mini1 G3 Mini1PM G3 PlugS G3
Switch & Co.1 ✓ ✓ ✓ ✗ ✓ ✓ ✓
Stateless Input2 ✓ ✓ ✓ ✓ ✓ ✓ ✗
Sensors3 ✓ ✓ ✓ ✓ ✓ ✓ ✗
Garage door opener ✓ ✓ ✓ ✗ ✓ ✓ ✗
Roller shutter mode ✗ ✗ ✓ ✗ ✗ ✗ ✗
Power measurement ✗ ✓ ✓ ✗ ✗ ✓ ✓
Temperature/Humidity measurement4 ✓ ✓ ✓ ✓ ✗ ✗ ✗

Plus devices

+1 +1Mini +1PMMini +1PM +2PM +i4 AC/DC +Plug S +Uni
Switch & Co.1 ✓ ✓ ✓ ✓ ✓ ✗ ✓ ✓
Stateless Input2 ✓ ✓ ✓ ✓ ✓ ✓ ✗ ✓
Sensors3 ✓ ✓ ✓ ✓ ✓ ✓ ✗ ✓
Garage door opener ✓ ✓ ✓ ✓ ✓ ✗ ✗ ✓
Roller shutter mode ✗ ✗ ✗ ✗ ✓ ✗ ✗ ✗
Power measurement ✗ ✗ - ✓ ✓ ✗ ✓ ✗
Temperature/Humidity measurement4 ✓ ✗ ✗ ✓ ✓ ✓ ✗ ✓

Light Controllers

+RGBWPM
Brightness control ✓
CCT ✓
RGB(W) ✓
Switch & Co 1 ✓
Power measurement -

Pro devices

Currently not supported.

Gen 1 switches

1 1PM 1L Plug PlugS 2 2.5 i3 UNI
Switch & Co.1 ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✗ ✓
Stateless Input2 ✓ ✓ ✓ ✗ ✗ ✓ ✓ ✓ ✓
Sensors3 ✓ ✓ ✓ ✗ ✗ ✓ ✓ ✓ ✓
Temperature/Humidity measurement ✓4 ✓4 ✗ ✗ ✗ ✗ ✗ ✗ ✓
Garage door opener ✓ ✓ ✗ ✗ ✗ ✓ ✓ ✗ ✓
Roller shutter mode ✗ ✗ ✗ ✗ ✗ ✗ ✓ ✗ ✗
Power measurement ✗ ✓ - ✓ ✓ ✗ ✓ ✗ ✗

Gen 1 light bulbs / led strips

Duo Duo RGBW Vintage RGBW2
Brightness control ✓ ✓ ✓ ✓
CCT ✓ ✗ ✗ ✓
RGB(W) ✗ ✓ ✗ ✓
Power measurement - - - -

Notes:
✓: supported
-: possible but not supported yet
✗: not possible
1: includes lock, outlet and valve
2: includes doorbell
3: includes motion, occupancy, contact, smoke, leak
4: with Sensor AddOn/Shelly Plus AddOn and DS18B20 sensor(s) (maximum 5 for Shelly Plus Addon, maximum 3 for Sensor AddOn) or 1 DHT sensor

Features that are not yet supported:

  • Cloud connections: no Shelly Cloud, no MQTT
  • Remote actions (web hooks)
  • Valve with timer support

Quick Start

Updating from stock firmware

  • Important: Please update to the latest stock firmware prior to converting to Shelly-HomeKit (1.7.5 on Plus/Gen3 Devices).

  • Watch a 2 minute video.

    • New: One link for all device types: http://A.B.C.D/ota?url=http://shelly.rojer.cloud/update
    If that doesn't work (did you remember to have the stock firmware at the correct version), try the link for a specific model

    • Gen 1 Devices:

      • Shelly 1: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-Shelly1.zip

      • Shelly 1L: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-Shelly1L.zip

      • Shelly 1PM: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-Shelly1PM.zip

      • Shelly 2: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-Shelly2.zip
        Note: Not for Shelly Dimmer 2!

      • Shelly 2.5: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-Shelly25.zip

      • Shelly Duo: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyDuo.zip

      • Shelly Duo RGBW (ColorBulb): http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyColorBulb.zip

      • Shelly i3: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyI3.zip

      • Shelly Plug: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlug.zip

      • Shelly Plug S: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlugS.zip

      • Shelly RGBW2: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyRGBW2.zip
        Note: The Shelly must be in color mode to flash, flashing in white mode is not supported!

      • Shelly UNI: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyUNI.zip

      • Shelly Vintage: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyVintage.zip

    • Gen 2 Devices

      • Shelly Plus 1: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlus1.zip

      • Shelly Plus 1 Mini: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlus1Mini.zip

      • Shelly Plus 1PM: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlus1PM.zip

      • Shelly Plus 1PM Mini: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlus1PMMini.zip

      • Shelly Plus 2PM: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlus2PM.zip

      • Shelly Plus Plug S: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlusPlugS.zip

      • Shelly Plus RGBWPM: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlusRGBWPM.zip

      • Shelly Plus I4 AC & DC: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlusI4.zip

      • Shelly Plus UNI: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyPlusUni.zip

    • Gen 3 Devices

      • Shelly 1 Gen3: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-Shelly1Gen3.zip

      • Shelly 1PM Gen3: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-Shelly1PMGen3.zip

      • Shelly 2PM Gen3: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-Shelly2PMGen3.zip

      • Shelly I4 Gen3: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyI4Gen3.zip

      • Shelly Mini 1 Gen3: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyMini1Gen3.zip

      • Shelly Mini 1 PM Gen3: http://A.B.C.D/ota?url=http://rojer.me/files/shelly/shelly-homekit-ShellyMini1PMGen3.zip

  • See here for detailed instructions.

  • Script here for an automated way to update your devices.

    • ./flash_shelly.py hostname (for single device)
    • ./flash_shelly.py -a (for all devices on the network)

Documentation

See our Wiki.

Getting Support

If you'd like to report a bug or a missing feature, please use GitHub issue tracker.

Some of us can be found in the Gitter chat room.

Contributions and Development

Code contributions are welcome! Check out open issues and feel free to pick one up.

See here for development environment setup.

Authors

See here.

Support

If you like to show support for the project and support further development, consider a Donation to the current maintainer markib via Paypal

License

This firmware is free software and is distributed under Apache 2.0 license.

Related repositories
ruvnet/RuView

π RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.

Rustcrates.ioMIT Licensedenseposewifi
cognitum.one/RuView
82.8k11.1k
arendst/Tasmota

Alternative firmware for ESP8266 and ESP32 based devices with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and entirely local control over MQTT, HTTP, Serial or KNX. Full documentation at

CGNU General Public License v3.0tasmotafirmware
tasmota.github.io/docs
24.6k5.1k
DarkFlippers/unleashed-firmware

Flipper Zero Unleashed Firmware

CGNU General Public License v3.0jailbreakkeeloq
flipperunleashed.com
21.9k1.9k
MarlinFirmware/Marlin

Marlin is a firmware for RepRap 3D printers optimized for both 8 and 32 bit microcontrollers. Marlin supports all common platforms. Many commercial 3D printers come with Marlin installed. Check with your vendor if you need source code for your specific machine.

C++GNU General Public License v3.0repraparduino
marlinfw.org
17.5k19.7k
flipperdevices/flipperzero-firmware

Flipper Zero firmware source code

CGNU General Public License v3.0nfcrfid
flipper.net
16.3k3.4k
gurugio/lowlevelprogramming-university

How to be low-level programmer

GNU General Public License v3.0linux-kernel-hackingc-programming
12.7k874
m3y54m/Embedded-Engineering-Roadmap

Comprehensive roadmap for aspiring Embedded Systems Engineers, featuring a curated list of learning resources

Creative Commons Attribution Share Alike 4.0 Internationalembeddedembedded-systems
12.4k1.3k
justcallmekoko/ESP32Marauder

A suite of WiFi/Bluetooth offensive and defensive tools for the ESP32

C++esp32arduino
11.6k1.4k
platformio/platformio-core

Your Gateway to Embedded Software Development Excellence :alien:

PythonPyPIApache License 2.0iotembedded
platformio.org
9.4k897
Next-Flip/Momentum-Firmware

🐬 Feature-rich, stable and customizable Flipper Firmware

CGNU General Public License v3.0customcustom-firmware
momentum-fw.dev
8.9k564
Ralim/IronOS

Open Source Soldering Iron firmware

CGNU General Public License v3.0firmwarets100
ralim.github.io/IronOS/
8.3k826
nodemcu/nodemcu-firmware

Lua based interactive firmware for ESP8266, ESP8285 and ESP32

CMIT Licensenodemculua
nodemcu.readthedocs.io
7.9k3.1k