Xtend Tuya
azerty9971/xtend_tuya · vv4.5.3
eXtend Tuya's integration
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
cover | Blind, garage door, window or door | |
climate | Thermostat | |
fan | Fan | |
humidifier | Humidifier or dehumidifier | |
lock | Lock | Needs its own HomeKit Bridge in accessory mode |
camera | Camera | Needs its own HomeKit Bridge in accessory mode |
remote | TV remote (activities) | Needs its own HomeKit Bridge in accessory mode |
alarm_control_panel | Security system | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
vacuum | Vacuum (as a switch) | |
button | Button (as a switch) | |
scene | Scene (as a switch) | |
select | Mode picker (as switches) |
What people report
Extends the core Tuya integration through the Tuya cloud API and needs OpenAPI credentials; many unsupported Tuya categories (locks, litter boxes, valves, sensors) get added quickly.
- Works8
- Partly works1
- Requested2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Costway 5-in-1 climate | Works Cloud | Capital-C 'Cool' HVAC mode now mappedSaved copyAdd Support for "Cool" from COSTWAY climate 5 in 1 device. Problem: Climate devices that send "Cool" (capital C) via DPS show unknown state in HA, because only "cool" (lowercase) is mapped in XT_HVAC_TUYA_TO_TUYALIB. The equivalent "Heat" (capital H) is already mapped correctly. Fix: Added "Cool": TuyaClimateHVACMode.COOL to the mapping dictionary, consistent with the existing "Heat" entry. Tested with: Device ProductKey 88h9lkn30fuca8ta (split AC unit) Excerpt saved from GitHub on 2026-10-23. | PR #980 · 2026-06 | |
| DOEL cat litter box | Works Cloud | Deep clean, switches and fault sensor addedSaved copySummary - msp (cat litter box DOEL ti+TpCTbt-01): adds `DEEP_CLEAN` button; adds `SWITCH`, `INDUCTION_CLEAN_2`, `DEVELOPER_MODE` switches; adds `FAULT` sensor using new `XTDPCodeBitmapLabelsWrapper` (decodes bitmask to human-readable fault labels) - hps (ZG-205Z presence sensor): adds `MOV_STATUS`, `DISTANCE`, `DETECTION_NEAR` sensors; adds `LED_ONOFF` switch (this device uses `led_onoff` instead of `indicator_led`) and `FALSE_BREATH` switch - zwjcy (SGS01 Bluetooth scale): adds a force-always-online mechanism, some BT-only devices without a hub always appear offline in the Tuya cloud … Excerpt saved from GitHub on 2026-10-23. | PR #842 · 2026-04 | |
| Poopy Nano 2 | Works Cloud | Support addedSaved copyThe original text was already deleted or overwritten when we archived it. | PR #589 · 2025-11 | |
| QOTO QT-08W irrigation valve | Works Cloud | Full support for fdm5kw valveSaved copyFollow-up to #1020, second part of the series discussed there. ## What this adds Full support for the fdm5kw irrigation valve (sfkzq category, QOTO QT-08W and the newer QT-08W-T3), driven by a dedicated entity parser under `entity_parser/fdm5kw/`: - Timer registry decoded from the `time_task` raw DP (slot model incl. the byte[1]=enabled flag), exposed as sensors with full schedule attributes; T3's indexed 4-program model (`sat_0`-packed battery, DP-instruction mode) handled by the same parser (`tests/test_t3_decode.py`). - Watering telemetry: cur_cap-based watering volume / flow rate, battery … Excerpt saved from GitHub on 2026-10-23. | PR #1025 · 2026-08 | |
| Tuya cloud BLE sensors | Works Cloud | Supported via OpenAPI credentialsSaved copy… guessing you don't see this because you are missing the OpenAPI credentials... > > Can you follow the following guide? https://github.com/azerty9971/xtend_tuya/blob/main/docs/cloud_credentials.md > > Have a nice day, Azerty Yes, i can confirm, some devices works, some not. Unfortunately, AOJ-33B Arm Blood Pressure Monitor works with Cloud sensors integration, and don't work with tuya xtend, but i use OT+XT+Cloud installation, because when I use XT+Cloud it sends reauthorization request once per day. Excerpt saved from GitHub on 2026-10-23. | Issue #557 · 2025-10 | |
| Tuya jtmspro and ms smart locks | Works Cloud | Could not lock/unlock; closed as fixed in latest versionSaved copyHello. I have a jtmspro lock (main door) and a ms lock (gate door) and apparently I'm not able to get them to work with xtend Tuya. I already had the IoT project bc I use LocalTuya and TuyaLocal. By watching this post I renewed my cloud credentials and I already added the "Smart Lock Open Service". I can see the devices in xtend tuya and the sensors are working, but the "operate lock" control to unlock doesn't do anything. Cloud credentials - OK and renewed Additional steps to configure locks - Done Basic lock information { "result": { "active_time": 1767842242, "bind_space_id": "7158503", … Excerpt saved from GitHub on 2026-10-23. | Issue #715 · 2026-01 | |
| Tuya T&H sensor and contact sensors | Works Cloud | Temp/humidity fixed in 4.1.3-beta.2; contact sensor needs workaroundSaved copyUpdated to the 4.1.3-beta.2; @azerty9971 1: Temperature and Humidity Sensor: Both sensors are now working! 2: Door windows Sensors: They are not giving unsupported error anymore but only one device is being detected, rest of them appear only battery status. See the screenshots please. Excerpt saved from GitHub on 2026-10-23. | Issue #430 · 2025-07 | |
| Tuya ZG-205Z presence sensor | Works Cloud | AddedSaved copySummary - msp (cat litter box DOEL ti+TpCTbt-01): adds `DEEP_CLEAN` button; adds `SWITCH`, `INDUCTION_CLEAN_2`, `DEVELOPER_MODE` switches; adds `FAULT` sensor using new `XTDPCodeBitmapLabelsWrapper` (decodes bitmask to human-readable fault labels) - hps (ZG-205Z presence sensor): adds `MOV_STATUS`, `DISTANCE`, `DETECTION_NEAR` sensors; adds `LED_ONOFF` switch (this device uses `led_onoff` instead of `indicator_led`) and `FALSE_BREATH` switch - zwjcy (SGS01 Bluetooth scale): adds a force-always-online mechanism, some BT-only devices without a hub always appear offline in the Tuya cloud … Excerpt saved from GitHub on 2026-10-23. | PR #842 · 2026-04 | |
| AlecoAir AM12 air conditioner | Partly works Cloud | Missing options and entities even with cloud credentialsSaved copy… answer 1 by 1 from the previous topic: - I don't see any disabled entity (screenshot below) - diagnostics attached : xtend_tuya-01K1VMD8ZPTBS11V5MPEQBXKH6-AM12 SMART COOL - AC Debara-47194800187f42250d66971d269b0865.json - I don't have tuya at all (I have also the others: LocalTuya and Tuya Local, should I try to remove those?) - The problem is still l Excerpt saved from GitHub on 2026-10-23. | Issue #455 · 2025-08 | |
| dé EV charger 11 kW | Requested | Vendor x_ codes support PR openSaved copyDevice dé EV charger / wallbox (11 kW, 3 phases), product id `witok7vhhjohtr02`, firmware 1.0.2. It reports category `qt` and only vendor specific `x_` DPCodes. The measurements are JSON documents inside String DPCodes (e.g. `x_metrics` = `{"L1":[2190,0,0],"L2":[…],"L3":[…],"t":280,"p":0,"d":67080,"e":176}`), so until now only generic, mostly disabled entities were created. Because of category `qt` it was also treated as an IR hub ("Add IR device" button, IR subscription check). ## Changes The change is purely additive: everything lives in a new entity parser plugin … Excerpt saved from GitHub on 2026-10-23. | PR #1083 · 2026-10 | |
| MOES ZC-TD Matter A60 RGBCW bulb | Requested | Support PR closed without mergeSaved copyAdd support for ZC-TD WIFI MATTER A60 9W 806LM E27 RGBCW Excerpt saved from GitHub on 2026-10-23. | PR #702 · 2026-01 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Cloud push
Goes through the maker’s cloud, which sends updates as they happen. Needs the internet and an account.
Found automatically over
- DHCP
Details
| Installs (analytics) | 3,395 (0.48%) |
|---|---|
| GitHub stars | 364 |
| Latest version | v4.5.3 (2026-10-14) |
| Set up in the UI | Yes |
| Maintainers | @azerty9971 |
| License | GPL-3.0 |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/azerty9971/xtend_tuya
- Source code: https://github.com/azerty9971/xtend_tuya
- Issues: https://github.com/azerty9971/xtend_tuya/issues
- HACS: https://hacs.xyz