Universal Tuya for Homey

Local Zigbee support for Tuya (and white-label) devices on Homey Pro. Switches, sensors, lights, thermostats, covers, valves — 431 drivers, 4,381 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 5 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.722
Drivers	431 (381 Zigbee + 50 WiFi)
Unique Fingerprints	4,381
Pairing Variants	16,489 (4 case combos per fingerprint)
Unique Product IDs	578
Flow Cards	5,182
Unique Capabilities	170
Native OTA Drivers	5
Test Suites	181 files
SVG Icons	731
Languages	EN, FR, NL, DE
SDK / Homey	3 / >= 12.2.0
Last Updated	2026-08-30

Top 20 Drivers by Fingerprint Count

#	Driver	Fingerprints
1	climate_sensor	2,360
2	switch_1gang	1,656
3	presence_sensor_radar	731
4	radiator_valve	599
5	button_wireless_2	572
6	wall_dimmer_tuya	490
7	generic_tuya	415
8	curtain_motor	382
9	device_radiator_valve	334
10	switch_4gang	276
11	switch_2gang	265
12	switch_3gang	214
13	motion_sensor	213
14	diy_custom_zigbee	206
15	soil_sensor	193
16	thermostat_tuya_dp	192
17	sensor_contact_zigbee	186
18	water_leak_sensor_tuya	178
19	usb_dongle_triple	168
20	contact_sensor	161

Drivers by Device Class

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

---

Latest Updates

Version	Changes
v9.0.722	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.721	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.720	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.719	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.718	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.717	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.716	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.715	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.714	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.713	Improved wireless button press capture for Tuya scene remotes after wake and pairing.
v9.0.712	Fixed driver image paths for App Store processing; restored Homey-safe icons.
v9.0.711	Fixed driver image paths for App Store processing; restored Homey-safe icons.

---

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.