Skip to content

About

new updated version

Resources

Code of conduct

Contributing

Stars

17 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

6,579 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Universal Tuya for Homey

Version Drivers Docs Issues

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).

Install

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.

Supported devices

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

Report a problem or request a device

GitHub issues are the way to report: open an issue. Please include:

  1. the manufacturer name (_TZE200_…, _TZ3000_…) and the model (TS0601, TS011F…) from Homey Developer Tools → Zigbee;
  2. the Zigbee interview (Developer Tools → the device → Interview), waking battery devices with their button;
  3. a diagnostic report code from this app (Apps → this app → Send diagnostic report);
  4. what the device is and what goes wrong.

Do not post local keys, tokens or other personal data. Details: device request guide.

Troubleshooting

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.

The three apps

  • 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

Documentation map

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)

Latest changes

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.

Credits

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.

License

See LICENSE. Community discussion: Homey forum topic; bug reports: GitHub issues.

About

new updated version

Resources

Code of conduct

Contributing

Stars

17 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages