Tuya Unified Zigbee App for Homey

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 430 drivers and 4,342 unique device fingerprints (17,084 including case variants for bulletproof pairing).

Key features:

• Local-only — everything runs on your Homey, nothing goes to the cloud
• Native Zigbee OTA — firmware updates shipped in-app for 6 drivers (Homey v13.2.0+), SHA512-verified
• Hybrid protocol engine — auto-detects Tuya DP (0xEF00) vs standard ZCL per device
• Bulletproof pairing — every fingerprint exists in 4 case combinations; runtime matching is fully case-insensitive
• Smart battery — non-linear per-chemistry curves, collapse-aware smoothing, no fabricated values
• 4,930 flow cards — triggers, conditions & actions in EN, FR, NL, DE
• Hue-style smart features — motion lighting with quiet hours, circadian (real solar position), wake-up/sleep ramps, scene capture/cycle

---

Installation

Method	Link
Homey App Store	Install from Homey App Store
Test Version	Install Test Version
GitHub Releases	View Releases

---

Statistics

Metric	Value
App Version	v9.0.434
Drivers	430 (380 Zigbee + 50 WiFi)
Unique Fingerprints	4,342
Pairing Variants	17,084 (4 case combos per fingerprint)
Unique Product IDs	571
Flow Cards	4,930
Unique Capabilities	170
Native OTA Drivers	6
Test Suites	65 files
SVG Icons	730
Languages	EN, FR, NL, DE
SDK / Homey	3 / >= 12.2.0
Last Updated	2026-08-05

Top 20 Drivers by Fingerprint Count

#	Driver	Fingerprints
1	climate_sensor	2,724
2	switch_1gang	1,785
3	button_wireless_2	866
4	generic_tuya	760
5	presence_sensor_radar	688
6	radiator_valve	587
7	wall_dimmer_tuya	480
8	device_radiator_valve	388
9	sensor_contact_zigbee	345
10	switch_4gang	248
11	curtain_motor	224
12	motion_sensor	210
13	diy_custom_zigbee	205
14	switch_2gang	204
15	thermostat_tuya_dp	200
16	water_leak_sensor_tuya	194
17	dimmer_wall_1gang	184
18	switch_3gang	184
19	dimmable_led_strip	180
20	soil_sensor	177

Drivers by Device Class

Class	Count
socket	117
sensor	112
light	61
other	30
thermostat	26
remote	18
button	17
fan	16
windowcoverings	11
lock	5
doorbell	4
garagedoor	4
heater	4
curtain	2
camera	1
vacuumcleaner	1
speaker	1

---

Latest Updates

Version	Changes
v9.0.434	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.433	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.432	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.431	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.430	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.429	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.428	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.427	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.426	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.425	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.424	Stability improvements and Homey test publication retry after transient processing failure.
v9.0.423	Stability improvements and Homey test publication retry after transient processing failure.

---

Key Features

Native Zigbee OTA (Homey v13.2.0+)

• Firmware updates shipped in-app for 6 drivers — flash directly from Homey, no manufacturer app needed
• OEM images only (Koenkk zigbee-OTA), SHA512-verified at build, sha256-verified at install
• Weekly auto-refresh via CI — new images land automatically when available
• For TS0601 MCU devices (no public firmware exists): detect + notify + guidance

Dual Protocol Support

• Tuya DP Protocol (Cluster 0xEF00) — full datapoint engine with a 756-manufacturer DP registry
• Standard ZCL — for native Zigbee 3.0 devices
• Auto-Detection — observes the device, then picks the best protocol with cross-protocol fallback

Bulletproof Pairing & Recognition

• Every Tuya fingerprint in 4 case combinations (pairing is case-sensitive in Homey core)
• Runtime matching via a single NFKD caseless normalizer (LRU-cached)
• Curated per-device routing database (mfs_db) with Sacred-Couple mfr+pid discipline

Buttons (physical + virtual)

• 10 detection methods with layered dedup (TSN ring, per-gang debounce, virtual/physical windows)
• One dropdown matrix card: button × action (single/double/long/triple/release)
• Scene mode auto-switch (0x8004) with manual-toggle detection
• Anti-spam: throttled virtual toggles, TX rate limiting on sleepy devices

Smart Battery Management

• 15+ battery chemistries with non-linear discharge curves
• Collapse-aware smoothing (real cell death surfaces immediately)
• Last-known persistence for sleepy devices; estimates marked, never fabricated
• Cycle counting and health intelligence

Hue-Style Smart Features

• Motion lighting with quiet-hours window + lux guard + auto-off
• Circadian lighting driven by real solar elevation
• Wake-up / sleep ramps, scene capture/apply/cycle (5 slots), all-off

WiFi Devices (Tuya Local-First)

• Local LAN control (protocols 3.1–3.5) with optional cloud recovery of local keys
• SmartLife QR pairing — no developer account needed
• UDP discovery with IP self-healing

---

Documentation

Doc	Content
docs/INDEX.md	Full documentation index
docs/P92_64_BUTTON_CROSS_MATRIX.md	Button implementations cross-reference (all sources, dated)
docs/P92_70_HOMEY_2026_OTA_NATIVE.md	Native OTA + Homey 2026 ecosystem
docs/CONTRIBUTING_DEV.md	Developer workflow (master/stable, tools, CI)
AGENTS.md	Project rules for AI agents
CHANGELOG.md	Full changelog

Community & Support

• Issues: GitHub Issues
• Forum: Homey Community Topic
• Upstream: Fork of JohanBendz/com.tuya.zigbee (superset: 430 vs 113 drivers)

License

MIT — see LICENSE and NOTICE. Factual data (fingerprints, datapoints, clusters) cross-referenced from zigbee2mqtt, ZHA, Hubitat, deCONZ and the Homey community — implementations are our own.