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,353 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.626
Drivers	431 (381 Zigbee + 50 WiFi)
Unique Fingerprints	4,353
Pairing Variants	16,515 (4 case combos per fingerprint)
Unique Product IDs	577
Flow Cards	5,178
Unique Capabilities	170
Native OTA Drivers	5
Test Suites	121 files
SVG Icons	731
Languages	EN, FR, NL, DE
SDK / Homey	3 / >= 12.2.0
Last Updated	2026-08-22

Top 20 Drivers by Fingerprint Count

#	Driver	Fingerprints
1	climate_sensor	2,463
2	switch_1gang	1,764
3	presence_sensor_radar	722
4	radiator_valve	599
5	button_wireless_2	578
6	wall_dimmer_tuya	496
7	generic_tuya	420
8	device_radiator_valve	380
9	curtain_motor	318
10	switch_4gang	272
11	switch_2gang	238
12	switch_3gang	212
13	motion_sensor	209
14	diy_custom_zigbee	206
15	thermostat_tuya_dp	192
16	soil_sensor	191
17	sensor_contact_zigbee	186
18	water_leak_sensor_tuya	182
19	usb_dongle_triple	176
20	contact_sensor	153

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.626	Docs cartography for dual App IDs; reliability carry-forward from 9.0.620.
v9.0.625	Docs cartography for dual App IDs; reliability carry-forward from 9.0.620.
v9.0.624	Docs cartography for dual App IDs; reliability carry-forward from 9.0.620.
v9.0.623	Docs cartography for dual App IDs; reliability carry-forward from 9.0.620.
v9.0.622	Docs cartography for dual App IDs; reliability carry-forward from 9.0.620.
v9.0.621	P2203 IAS already-enrolled bind + water EF00 skip + FP hygiene.
v9.0.620	P2203 IAS already-enrolled bind + water EF00 skip + FP hygiene.
v9.0.619	P2203 IAS already-enrolled bind + water EF00 skip + FP hygiene.
v9.0.618	P2203 IAS already-enrolled bind + water EF00 skip + FP hygiene.
v9.0.617	P2203: IAS already-enrolled bind + IAS-only water EF00 skip; FP hygiene 2putqrmw.
v9.0.616	P2203 hygiene: strip plug mfr 2putqrmw from button_wireless_2 (FP collision); version sync.
v9.0.615	P2203: re-bind IAS Zone when already enrolled (Peter water/contact after app restart); skip EF00 Tuya mirror on IAS-only water sensors; s…

---

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.