Warning This is third-party firmware. It can brick your device if something goes wrong. There is no warranty. If you're not comfortable with
adband the idea of rooting a device that costs real money, stop here.
ShellyElevate replaces the stock software on a Shelly Wall Display. The stock app works, but the WebView crashes, hardware access is locked down, and you can't really build anything on top of it. This project gives you a stable Home Assistant kiosk, exposes the relays, sensors and buttons over MQTT and HTTP, and lets your dashboard talk to the hardware directly from JavaScript.
ShellyElevateV2.mp4
- A WebView wrapper that doesn't fall over after a few hours
- MQTT with full Home Assistant auto-discovery (temperature, humidity, light, proximity, relays, buttons, swipe events)
- A REST API on port 8080 for everything the device can do
- A JavaScript bridge so your dashboard can read sensors and flip relays without going through HA
- Auto-brightness from the light sensor, screensavers, wake-on-proximity
- Optional extras: Home Assistant voice pipeline (with wake word), Bluetooth proxy for HA, dimmer support over UART
- A "lite" mode if you'd rather use Fully Kiosk or a Companion app but still want the hardware exposed
Every Shelly Wall Display model is supported, with the right temperature offsets and relay/button counts picked automatically. See Supported Devices for the full list.
- Install ShellyElevate: enable developer mode, sideload the APK over
adb - First-time setup: point it at your Home Assistant URL
- Pick what you want to use:
- Home Assistant integration (the common path)
- HTTP API or MQTT (if you're not using HA, or just want to script things)
- JavaScript bridge (if you're building your own dashboard)
Prebuilt APKs are on the Releases page.
Everything lives in the Wiki:
| Setup | Installation · First-Time Setup · Supported Devices · Configuration Reference |
| Integration | Home Assistant · MQTT · HTTP API · JavaScript Interface |
| Features | Screensavers · Voice Assistant · Bluetooth Proxy · Kiosk & Lite Mode |
| Reference | Hardware Reference · Building from Source · Troubleshooting |
Bug reports and PRs are welcome. If you're sending a PR, test on actual hardware. The codebase is full of small workarounds for specific Shelly models and emulators won't catch them.
For issues, the issue tracker is the right place. If you're stuck on setup, check Troubleshooting first. Most setup problems are covered there.
See LICENSE. Provided "as is", at your own risk.