# Shelly Device support for Z-Box (Quickapp) **URL:** \ **Category:** Z-Box\ **Tags:** quickapps\ **Created:** [May 31, 2026, 12:40pm UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810 "2026-05-31T12:40:30Z")\ **Posts on this page:** 8\ **Page:** 1
**Author:** ![darren.stp](https://yyz1.discourse-cdn.com/flex003/user_avatar/www.zoozcommunity.com/darren.stp/32/217_2.png) [@darren.stp](https://www.zoozcommunity.com/u/darren.stp)\ **Post date:** [May 31, 2026, 12:40pm UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810/1 "2026-05-31T12:40:30Z")
# Shelly QuickApps for Z-Box Hello, I’ve been spending some time building out a set of QuickApps to integrate Shelly Wi-Fi devices with the Z-Box, and I’ve just published them publicly on GitHub. This was borne out of my own needs, so I could only test the devices I had on hand. Also it is a beta release at the moment and definitely has room for improvement. But it is a start! ## What’s included Five QuickApps each targeted at a specific Shelly device type: - **Shelly Gen3/Gen4 Relays & Plugs** — on/off control with optional power meter and illuminance child devices - **Shelly EM Gen1** — dual-channel energy monitoring - **Shelly EM Gen3** — dual-channel energy monitoring - **Shelly PM Mini Gen3** — single-channel power monitoring - **Shelly i4 / i4 DC** — 4-input button device, full single/double/triple/long press support (Note that these may work with other devices than those listed… so experimentation is key) Since this is all IP based, all communication is **fully local**. It is not using Shelly’s cloud or any third-party services. Just your Z-Box talking directly to your Shelly devices over your local network. So, it requires your device to be in IP (wifi or ethernet if a pro device) mode. Zigbee or Matter mode won’t function with these Quickapps. (And if you have a z-wave Shelly, obviously you don’t need this at all 🙂 ) ## Two ways to install **Simple:** Download the `.fqa` file from the Releases page and upload it straight to your Z-Box — no coding required. **Advanced:** Grab the Lua source from the repo if you want to dig in, customise, or follow along with updates. ## GitHub repo 👉 [GitHub - savethepanel/zbox-shelly-quickapp: Shelly Wi-Fi device integration for Zooz Z-Box via Lua QuickApps. · GitHub](https://github.com/SaveThePanel/zbox-shelly-quickapp) The README covers installation, configuration variables, and device-specific setup details. If you run into issues or have feature requests, GitHub Issues is the best place to track them — or just reply here. I’ll be posting a YouTube video shortly with a walkthrough and setup guide — I’ll drop the link in a reply once it’s live. Hopefully this is useful! Enjoy. ---
**Author:** ![Barkis](https://yyz1.discourse-cdn.com/flex003/user_avatar/www.zoozcommunity.com/barkis/32/50_2.png) [@Barkis](https://www.zoozcommunity.com/u/Barkis)\ **Post date:** [May 31, 2026, 3:51pm UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810/2 "2026-05-31T15:51:16Z")
Nice work–and well documented, too. 😎 ---
**Author:** ![darren.stp](https://yyz1.discourse-cdn.com/flex003/user_avatar/www.zoozcommunity.com/darren.stp/32/217_2.png) [@darren.stp](https://www.zoozcommunity.com/u/darren.stp)\ **Post date:** [June 1, 2026, 1:51pm UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810/3 "2026-06-01T13:51:00Z")
Thank you. Truth be told - I documented the one script and had Claude go through them all for code review, cleanup and standardizing the documentation / comments. Claude isn’t perfect, but it is my new employee of the month. 😂 ---
**Author:** ![Agnes](https://yyz1.discourse-cdn.com/flex003/user_avatar/www.zoozcommunity.com/agnes/32/14_2.png) [@Agnes](https://www.zoozcommunity.com/u/Agnes)\ **Post date:** [June 2, 2026, 4:12pm UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810/4 "2026-06-02T16:12:59Z")
Great work, thanks so much for sharing! Do you mind if we create a support article for the Z-Box portal based on your documentation and contribution so users can easily find it? 😊 I’m trying to think of the best place to start a library for the Z-Box specific quick apps since in another thread you mentioned the Nice/Fibaro marketplace wasn’t too intuitive. Maybe we could create a dedicated section for them in the Z-Box Support Portal? ---
**Author:** ![darren.stp](https://yyz1.discourse-cdn.com/flex003/user_avatar/www.zoozcommunity.com/darren.stp/32/217_2.png) [@darren.stp](https://www.zoozcommunity.com/u/darren.stp)\ **Post date:** [June 4, 2026, 1:38am UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810/5 "2026-06-04T01:38:22Z")
Hi @Agnes, I don’t mind at all. Happy to contribute. 😃 ---
**Author:** ![darren.stp](https://yyz1.discourse-cdn.com/flex003/user_avatar/www.zoozcommunity.com/darren.stp/32/217_2.png) [@darren.stp](https://www.zoozcommunity.com/u/darren.stp)\ **Post date:** [June 7, 2026, 9:23pm UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810/6 "2026-06-07T21:23:36Z")
Video is up walking through these QuickApps! [![](https://canada1.discourse-cdn.com/flex003/uploads/zoozcommunity/original/1X/48e200dceb7bff6a524005526b097669f400b062.jpeg "Local Shelly Support on the Zooz Z-Box | Going Beyond Z-Wave with QuickApps!") ](https://www.youtube.com/watch?v=ZsDtOwB1BuY) ---
**Author:** ![Agnes](https://yyz1.discourse-cdn.com/flex003/user_avatar/www.zoozcommunity.com/agnes/32/14_2.png) [@Agnes](https://www.zoozcommunity.com/u/Agnes)\ **Post date:** [June 8, 2026, 1:13pm UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810/7 "2026-06-08T13:13:47Z")
That’s awesome, thanks so much for creating this guide too! We will incorporate it in the documentation, this is super helpful 🙂 ---
**Author:** ![Barkis](https://yyz1.discourse-cdn.com/flex003/user_avatar/www.zoozcommunity.com/barkis/32/50_2.png) [@Barkis](https://www.zoozcommunity.com/u/Barkis)\ **Post date:** [June 14, 2026, 4:09pm UTC](https://www.zoozcommunity.com/t/shelly-device-support-for-z-box-quickapp/810/8 "2026-06-14T16:09:11Z")
Yet another very well done video, Darren! 😎 Just watched it from end to end and it also gave me some idea of how the Shelly devices work, as I don’t have any at this point.