Shelly Device support for Z-Box (Quickapp)

Z-Box
1

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 :slight_smile: )

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

:backhand_index_pointing_right: GitHub - savethepanel/zbox-shelly-quickapp: Shelly Wi-Fi device integration for Zooz Z-Box via Lua QuickApps. · GitHub

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.

4 Likes
2

Nice work–and well documented, too. :smiling_face_with_sunglasses:

1 Like
3

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. :joy:

3 Likes
4

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? :blush: 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?

3 Likes
5

Hi @Agnes, I don’t mind at all. Happy to contribute. :smiley:

6

Video is up walking through these QuickApps!

3 Likes
7

That’s awesome, thanks so much for creating this guide too! We will incorporate it in the documentation, this is super helpful :slightly_smiling_face:

2 Likes