Hey everyone — time for a proper update on where things stand.
The landscape has shifted.
There are now effectively 3 apps / 2 branches for Tuya Zigbee on Homey, and the documentation in the repo explains the differences in detail:
-
JohanBendz / com.johanbendz.tuya.zigbee — The original. Johan stepped away from active development long ago. This app still works for many basic devices but receives no updates. New fingerprints, bug fixes, and modern devices are not being added there but now Johan is back and the devellopment is restarted.
-
dlnraja / com.dlnraja.tuya.zigbee (v7.x “master” branch) — The bleeding edge. This is the unified engine with adaptive DP mapping, the Antigravity runtime (L0-L14 quality layers), self-healing fleet stability, adaptive lighting, cross-protocol fallback, the UnifiedBatteryHandler, and full PhysicalButtonMixin / VirtualButtonMixin support. It currently sits at v7.5.50. This is where all new development happens — at the cost of some complexity.
-
dlnraja / com.dlnraja.tuya.zigbee.stable (v5.x “stable-v5” branch) — The stable, proven track. A curated subset of ~50 essential drivers, static DP mappings, no adaptive magic. Think of it as “v7’s foundations, frozen and polished.” It compiles to a separate App ID in the Homey store, so both can sit side-by-side on the same Homey without conflict. Currently at v5.11.212 (not yet pushed — next batch).
Full documentation explaining the architectural differences, branch strategy, and migration path is available in the GitHub repo (
/docs/branches.md). Please read it before asking which version to use.
Which one should you use?
-
If you just want things to work with your switches, sensors, thermostats, plugs, and lights → stick with the stable-v5 app (
com.dlnraja.tuya.zigbee.stable). It’s simpler, battle-tested, and won’t surprise you. -
If you have exotic or newer devices, want the latest fingerprint coverage, advanced features (virtual buttons, adaptive metering, cross-protocol self-healing), or are willing to help test → use the master app (
com.dlnraja.tuya.zigbee).
Critical disclaimer — please read carefully
These apps are provided “as-is”, likely buggy, and may not be fully functional.
Due to severe time constraints and the sheer complexity of the Tuya Zigbee ecosystem (4200+ fingerprints, 126K+ DB entries, constantly changing OEM variants), I cannot guarantee stability, completeness, or backward compatibility. You install at your own risk. Always backup your Homey before testing.
A personal note — why I’m stepping back from community development
I need to be transparent about where my head is at:
I’ve paused active development for the community.
Over recent months, I’ve received virulent messages, unreasonable demands, and entitlement-driven criticism. I build this software in my spare time, as a hobby and a learning project. I use AI tools to automate repetitive dev tasks because I simply don’t have the bandwidth to do everything manually — but that doesn’t mean I owe anyone a production-grade, enterprise-supported product. I’m not comfortable with the tone of some interactions, and I’ve decided to protect my peace.
I’m continuing development — for myself.
I still use these apps daily in my own setup. I’ll keep fixing bugs that affect me, adding fingerprints for devices I own, and refining the architecture because I find it rewarding. But I’m no longer committing to public roadmaps, forum support SLAs, or feature requests from strangers. This is my hobby, my code, my time. I don’t owe anyone an account — and I hope that’s understood.
Life update: I recently lost my job (at the employer’s initiative) and am actively searching for stable employment. My priority right now is rebuilding professional stability. That necessarily limits the time and emotional energy I can invest in open-source maintenance.
Important clarification: None of these apps are public on the Homey Store. They have never passed the official publication review. Everything shared on GitHub or via direct APK/CLI install is strictly for testing, hobby, and personal use. You install at your own risk. No warranties, no guarantees, no support commitments.
Read the thread history for context:
If you want to understand the full journey — the technical challenges, the community dynamics, the decisions behind the dual-branch strategy — please read the forum thread from the beginning:
[APP][Pro] Universal TUYA Zigbee Device App - test
It’s all there. I’m not hiding anything.
What about new development?
Going forward:
- Critical bug fixes affecting core stability will still be shipped on both tracks — when I have time.
- New fingerprints will be added when I acquire the device or receive reliable logs — but expect slower cadence.
- The existing codebase is open and free — fork it, improve it, make it yours. Both branches are on GitHub at
github.com/dlnraja/com.tuya.zigbee. - I will still read the forum thread (T140352) but may not reply to every post. If it’s urgent and reproducible, open a GitHub issue with logs.
One more thing — the USB dongle users asked about (_TZ3000_h1ipgkwn and _TZ3000_iwtv2jwo, TS0002):
This device (the 2-port USB relay + Zigbee repeater, sold by SL SYS and others) is now properly supported in v7.5.50 with a dedicated switch_usb_dongle driver. It was previously being caught by light_dimmable and switch_3gang in error — both wrong. If you have one, re-pair it with the new version and it’ll show up correctly as a 2-port USB socket with on/off control for each port plus power-on behavior settings.
Final word
Thanks to everyone who has contributed feedback, logs, or kind words over the years. Building what’s now the largest Tuya Zigbee app for Homey has been a hell of a ride. I’m proud of what we’ve built — and I’ll keep tinkering, quietly, for my own setup.
If you choose to use these apps: test carefully, backup your Homey, and don’t deploy to production environments. And please — be kind. Open source thrives on collaboration, not entitlement.
— Dylan
