Local control of Tuya and white-label devices on Homey Pro, without the Tuya cloud for Zigbee.
This branch is master: Main app: newest drivers and features. Ships to the Test channel first, then Live.
Full documentation: https://dlnraja.github.io/com.tuya.zigbee/docs/ (searchable device list, FAQ, request guide, architecture, knowledge base).
| Channel | Link | What it is |
|---|---|---|
| Test | https://homey.app/a/com.dlnraja.tuya.zigbee/test/ | Every new version first; fixes arrive here days earlier |
Use only one of the three apps for a given device. Versions go to Test first (no Live release yet). Release notes: changelog · GitHub releases.
Generated from app.json v9.0.1634:
| Metric | Value |
|---|---|
| Drivers | 476 (420 Zigbee, 54 Wi-Fi, 2 other) |
| Manufacturer names (case-insensitive) | 4,913 |
| Model / product ids | 588 |
| Capabilities used | 216 |
Search your device by manufacturer name or model: supported devices.
Top 15 drivers by manufacturer names
| # | Driver | Class | Manufacturer names | Models |
|---|---|---|---|---|
| 1 | climate_sensor |
sensor | 483 | CK-TLSR8656-SS5-01(7014), CK-TLSR8656-SS5-02(7014), lumi.sensor_ht, lumi.sensor_ht.agl02 … |
| 2 | switch_1gang |
socket | 356 | 01MINIZB, BASICZBR3, S26R2ZB, S31ZB … |
| 3 | curtain_motor |
windowcoverings | 271 | 01minizb, am02, AM43-0.45/40-ES-EB, AM43-0.45/40-ES-EZ … |
| 4 | presence_sensor_radar |
sensor | 251 | AY-204ZX, AY204T, AY205Z, AY208Z … |
| 5 | generic_tuya |
other | 190 | TS0203, TS0601_generic, TS0603 |
| 6 | radiator_valve |
thermostat | 166 | 014G2461, 014G2463, BASICZBR3, BSP-EZ2 … |
| 7 | wall_dimmer_tuya |
light | 134 | TS0001, TS0002, TS0003, TS0004 … |
| 8 | device_radiator_valve |
thermostat | 109 | eaxp72v, TS0601 |
| 9 | diy_custom_zigbee |
other | 103 | ARDUINO_ZIGBEE, BUTTON, CC1352_DEV, CC1352P_DEV … |
| 10 | switch_2gang |
socket | 103 | LXN59-2S7LX1.0, TS0002, TS0002_power, TS0002_switch_module … |
| 11 | soil_sensor |
sensor | 89 | Arteco, AY-302Z, AY-303Z, CS-201Z … |
| 12 | button_wireless_2 |
button | 88 | 01MINIZB, A7Z, BASICZBR3, CK-BL702-SWP-01(7020) … |
| 13 | switch_4gang |
socket | 84 | 01MINIZB, BASICZBR3, JZ-ZB-004, S26R2ZB … |
| 14 | switch_3gang |
socket | 80 | 01MINIZB, BASICZBR3, JZ-ZB-004, S26R2ZB … |
| 15 | motion_sensor |
sensor | 75 | 3305-S, 3325-S, 3326-L, CK-BL702-MWS-01 … |
Drivers by class
socket 124 · sensor 121 · light 68 · other 35 · thermostat 28 · button 27 · remote 18 · fan 14 · windowcoverings 14 · heater 7 · lock 5 · doorbell 4 · garagedoor 4 · curtain 2 · homealarm 1 · camera 1 · kettle 1 · vacuumcleaner 1 · speaker 1
GitHub issues are the way to report: open an issue. Please include:
- the manufacturer name (
_TZE200_…,_TZ3000_…) and the model (TS0601,TS011F…) from Homey Developer Tools → Zigbee; - the Zigbee interview (Developer Tools → the device → Interview), waking battery devices with their button;
- a diagnostic report code from this app (Apps → this app → Send diagnostic report);
- what the device is and what goes wrong.
Do not post local keys, tokens or other personal data. Details: device request guide.
| Problem | First thing to try |
|---|---|
| Pairs as unknown / generic / wrong class | Check the device list; update (Test channel), remove and re-pair |
| Button does nothing | Use the device's own trigger card; check scene vs dimmer mode (FAQ) |
| Clock or settings not applied on a battery device | Wake it with its button; writes wait for the next wake-up |
| Battery empty or stuck | Wait for the first report; some devices only send "battery low" |
| Wi-Fi device offline / one socket only | See the Wi-Fi section of the FAQ |
| Flow card unknown | Re-select the card in the Flow and save |
All answers: FAQ.
- Tuya Unified (Stable) (
stable-v5): Reliability line: receives fixes from master after a soak period; fewer moving parts. Code - Zigbee Bastien (
bastien-home): Dedicated build for one community installation; gets master fixes after they are proven. Code
| Where | What |
|---|---|
| Docs site | Home, devices, FAQ, request guide, changelog, architecture, knowledge base, credits, sources, contributing |
| docs/ | Repository docs; docs/site-src/ holds the hand-written pages, docs/tools/ the generators |
| drivers/ | One folder per driver; driver.compose.json is the source of truth |
| lib/ | Shared runtime modules |
| scripts/ | Maintenance and CI scripts (not shipped to Homey) |
| CONTRIBUTING.md | How to contribute (web version) |
| CREDITS.md | People and projects we learned from (web version) |
| Version | Date | Changes |
|---|---|---|
| 9.0.497 | 2026-08-14 | Hardened TS004F remote routing against publish re-inject bot; remotes stay on 4-button driver. |
| 9.0.496 | 2026-08-14 | Restored Moes/Lidl TS004F remotes to 4-button driver; migrated IR remote and CT clamp off bare ZigBeeDevice; battery unknown until first report. |
| 9.0.478 | 2026-08-11 | Crash-safe error handlers; rain/contact/soil/gas fingerprint rehomes; settings device-list timeout. |
| 9.0.477 | 2026-08-11 | Crash-safe error handlers; rain/contact/soil/gas fingerprint rehomes; settings device-list timeout. |
| 9.0.476 | 2026-08-11 | Improved cross-project reimpl: quirk battery DPs, IAS siren I/O, energy jump guard on all bases, sleepy wake battery probe. |
| 9.0.475 | 2026-08-11 | Fixed ghost button flows and phantom battery Energy tiles; no more fake battery percentages on mains devices. |
| 9.0.474 | 2026-08-11 | Multi-source enrich automation; reinforced curtain/gas/dimmer/radar/thermostat fingerprints; stronger DeviceIO RX/TX fallbacks. |
| 9.0.473 | 2026-08-11 | Multi-source enrich automation; reinforced curtain/gas/dimmer/radar/thermostat fingerprints; stronger DeviceIO RX/TX fallbacks. |
This app builds on the Homey SDK and on public knowledge from Zigbee2MQTT, ZHA, deCONZ, Blakadder, tuya-local, tinytuya, Johan Bendz's original Tuya Zigbee app and many community testers. Everything is rewritten in our own words and code; see CREDITS.md and sources.
See LICENSE. Community discussion: Homey forum topic; bug reports: GitHub issues.