Universal Tuya for Homey

Local Zigbee support for Tuya (and white-label) devices on Homey Pro. Switches, sensors, lights, thermostats, covers, valves — 434 drivers, 4,694 unique fingerprints. No cloud required.

What it does:

• Talks to devices on your Homey Zigbee mesh (Tuya DP 0xEF00 and standard ZCL)
• Case-insensitive fingerprint matching so pairing is reliable across OEM variants
• Battery curves by chemistry (no linear % guesses)
• Flow cards for physical buttons, sensors, and actuators (EN, FR, NL, DE)
• Optional native Zigbee OTA for 8 drivers (Homey v13.2.0+)

---

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.1145
Drivers	434 (381 Zigbee + 53 WiFi)
Unique Fingerprints	4,694
Pairing Variants	16,428 (4 case combos per fingerprint)
Unique Product IDs	598
Flow Cards	6,052
Unique Capabilities	170
Native OTA Drivers	8
Test Suites	438 files
SVG Icons	734
Languages	EN, FR, NL, DE
SDK / Homey	3 / >= 12.2.0
Last Updated	2026-09-21

Top 20 Drivers by Fingerprint Count

#	Driver	Fingerprints
1	climate_sensor	2,129
2	switch_1gang	1,499
3	curtain_motor	669
4	presence_sensor_radar	615
5	radiator_valve	602
6	button_wireless_2	570
7	generic_tuya	414
8	device_radiator_valve	356
9	wall_dimmer_tuya	301
10	switch_4gang	300
11	motion_sensor	247
12	switch_3gang	219
13	contact_sensor	210
14	diy_custom_zigbee	206
15	thermostat_tuya_dp	197
16	switch_2gang	185
17	sensor_contact_zigbee	183
18	water_leak_sensor_tuya	181
19	wall_thermostat	170
20	soil_sensor	165

Drivers by Device Class

Class	Count
socket	117
sensor	108
light	60
other	31
button	26
thermostat	26
remote	18
fan	13
windowcoverings	11
lock	5
heater	5
doorbell	4
garagedoor	4
curtain	2
camera	1
kettle	1
vacuumcleaner	1
speaker	1

---

Latest Updates

Version	Changes
v9.0.1145	P2645: sleepy remotes skip battery configure on pair; quiet Time 0x000A logs.
v9.0.1144	P2644b: wall remote TS0041-only — stop 3ch remotes pairing as 1-button (Bastien 4d4e1684).
v9.0.1143	P2644: fix switch flow card IDs + remote CI crash (Bastien diags).
v9.0.1142	Fixed app settings blank infinite loader (Homey.ready before mesh/WiFi scan).
v9.0.1141	Improved WiFi LAN reliability and eWeLink climate pairing.
v9.0.1140	Improved WiFi LAN reliability and climate sensor pairing.
v9.0.1139	Improved WiFi LAN reliability and wall remote hybrid RX.
v9.0.1138	Improved WiFi LAN reliability and wall remote Homey UI sync.
v9.0.1137	Improved WiFi LAN reliability and fingerprint database alignment.
v9.0.1136	Improved WiFi LAN reliability and fingerprint routing.
v9.0.1135	WiFi EV: phase-JSON + proven charge-history kWh (no e/d guess). LAN stale-data reconnect + fire-and-forget SET. Credits Tuya Local (andiw…
v9.0.1134	TS0043 _TZ3000_famkxci2 stays Wireless Button 3 (no Generic Zigbee). Curtain TS130F e3vhyirx wall switch lock. Ceiling radar presence cle…

---

Key Features

Pairing & recognition

• Fingerprints stored in multiple case forms (Homey core matching is case-sensitive)
• Runtime caseless matcher + Sacred Couple discipline (manufacturerName + productId)

Buttons

• Physical and virtual presses with debounce / anti-spam
• Flow cards for single / double / long / triple where the hardware supports it

Battery

• Non-linear curves by chemistry — no fabricated percentages

Extras (master / Test channel)

• Motion lighting helpers, circadian ramps, scene tools where enabled
• Optional WiFi local-first for a subset of Tuya LAN devices

---

Documentation

Doc	Content
docs/INDEX.md	Full documentation index
docs/rules/DUAL_APP_VISION.md	master (preview) vs stable-v5 (reliability)
docs/CONTRIBUTING_DEV.md	Developer workflow
AGENTS.md	Project rules for AI agents
CHANGELOG.md	Full changelog

Community & Support

• Issues: GitHub Issues
• Forum: Homey Community Topic — prefer silent code fixes over bot replies

License

GPL-3.0 — see LICENSE. Fingerprint / DP facts cross-checked against public Zigbee sources; app code is this project's.