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,384 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 9 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.768
Drivers	431 (381 Zigbee + 50 WiFi)
Unique Fingerprints	4,384
Pairing Variants	16,322 (4 case combos per fingerprint)
Unique Product IDs	576
Flow Cards	5,198
Unique Capabilities	170
Native OTA Drivers	9
Test Suites	205 files
SVG Icons	731
Languages	EN, FR, NL, DE
SDK / Homey	3 / >= 12.2.0
Last Updated	2026-09-01

Top 20 Drivers by Fingerprint Count

#	Driver	Fingerprints
1	climate_sensor	2,136
2	switch_1gang	1,568
3	presence_sensor_radar	731
4	curtain_motor	620
5	radiator_valve	599
6	button_wireless_2	564
7	wall_dimmer_tuya	490
8	generic_tuya	415
9	device_radiator_valve	334
10	switch_4gang	276
11	switch_2gang	253
12	switch_3gang	214
13	motion_sensor	213
14	diy_custom_zigbee	206
15	thermostat_tuya_dp	192
16	soil_sensor	189
17	sensor_contact_zigbee	182
18	water_leak_sensor_tuya	178
19	usb_dongle_triple	164
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.768	Improved curtain motors: EF00 RX hardening, timeout-safe position updates, and more verified cover fingerprints.
v9.0.767	Exclusive plug routing for TS011F w0qqde0g fingerprints (energy monitor only).
v9.0.766	Exclusive plug routing for TS011F w0qqde0g fingerprints (energy monitor only).
v9.0.765	Locked TS011F plug fingerprints in mfs_db so bots cannot re-route them to wireless buttons.
v9.0.763	Locked TS011F plug fingerprints away from wireless buttons (mfs + case variants).
v9.0.762	Stripped leftover plug fingerprint case-variants from wireless buttons; keep TS011F plugs on energy monitor.
v9.0.761	Fixed smart plug fingerprint routing so TS011F plugs are not matched as wireless buttons.
v9.0.760	Improved MCU time sync and battery cover init; safer dimmer brightness scaling for Tuya devices.
v9.0.759	Improved MCU time sync and battery cover init; safer dimmer brightness scaling for Tuya devices.
v9.0.758	Moes curtain DP3/7/8/10 + Homey Device Updates OTA (P2356/P2357).
v9.0.757	Moes curtain DP3/7/8/10 + Homey Device Updates OTA (P2356/P2357).
v9.0.756	Moes curtain DP3/7/8/10 + Homey Device Updates OTA (P2356/P2357).

---

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.