A community-driven Homey app that brings local control to Tuya Zigbee devices — no cloud, no internet needed. Covers switches, sensors, lights, thermostats, covers, locks, and more across 431 drivers and 5,275+ device fingerprints.

Key features:

• Local-only — everything runs on your Homey, nothing goes to the cloud
• Hybrid mode — auto-detects whether a device speaks Tuya DP or standard ZCL
• Smart battery — voltage-based fallback when devices don't report percentage
• 4,844+ flow cards — triggers, conditions & actions in EN, FR, NL, DE
• SDK3 — built on the latest Homey platform

• Tuya DP Protocol (Cluster 0xEF00) - For Tuya-specific devices
• Standard ZCL - For native Zigbee 3.0 devices
• Auto-Detection - Observes device for 15 min, then picks the best protocol

• 8 battery chemistries supported
• 4 calculation algorithms
• Voltage-based fallback when percentage unavailable

• Full kWh, W, V, A support
• Configurable ZCL energy divisors
• Auto-removal of unused energy capabilities after 15 min

• 2000ms timeout-based detection
• Flow triggers for physical button presses per gang
• Deduplication to prevent duplicate triggers

BSEED, Zemismart, Moes, AVATTO, Lonsonho, HOBEIAN, Lidl/Silvercrest, eWeLink/SONOFF, Girier, Benexmart, Owon, and hundreds more via Tuya OEM fingerprints.

Homey Pro
  └─ Tuya Unified Zigbee App (SDK3)
       ├─ Hybrid Protocol Engine
       │    ├─ Tuya DP (Cluster 0xEF00) ─ DP1-DP255 data points
       │    └─ Standard ZCL ─ onOff, levelControl, colorControl, etc.
       ├─ DeviceProfileRegistry (149 profiles)
       │    └─ Per-fingerprint: DP mappings, quirks, timing
       ├─ BatteryManager (8 chemistries, voltage fallback)
       ├─ PhysicalButtonMixin (2000ms detection)
       └─ 431 Drivers ─ 5,275+ fingerprints

Re-pairing required after driver updates to apply new mappings.

• Node.js 18+
• Homey CLI: npm install -g homey

git clone https://github.com/dlnraja/com.tuya.zigbee.git
cd com.tuya.zigbee
npm install
homey app run

homey app build
homey app validate --level publish
homey app run

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-device)
3. Validate: homey app validate --level publish
4. Submit a pull request with description

1. Get a device interview from Homey Developer Tools
2. Check Zigbee2MQTT for DP mappings
3. Check Blakadder for cross-references
4. Open an issue with: manufacturerName, modelId, and interview data

1. Go to Settings > Apps > Tuya Unified Zigbee > Send Diagnostics
2. Open a bug report with: device model, error messages, and diagnostics code

This app is developed in my free time, powered by passion and coffee!

100% optional - Your feedback and bug reports are equally valuable!

A massive thank you to the maintainers and contributors of:

• Koenkk and all contributors to Zigbee2MQTT
• blakadder and the Zigbee Device Compatibility Repository
• The zigpy / ZHA / zha-device-handlers maintainers
• The CSA (Connectivity Standards Alliance) for the Zigbee specifications
• All developers and testers who share device logs, diagnostics, and fingerprints

GPL-3.0 - See LICENSE file

Made with love by Dylan Rajasekaram & the Zigbee community

Last updated: 2026-07-20