Skip to content
Home Assistant TestFlight
Lighting

Xtend Tuya

azerty9971/xtend_tuya · vv4.5.3

HACSCloud push

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.

EntityShows up asNote
lightLight
switchSwitch or outlet
coverBlind, garage door, window or door
climateThermostat
fanFan
humidifierHumidifier or dehumidifier
lockLockNeeds its own HomeKit Bridge in accessory mode
cameraCameraNeeds its own HomeKit Bridge in accessory mode
remoteTV remote (activities)Needs its own HomeKit Bridge in accessory mode
alarm_control_panelSecurity system
binary_sensorSensor (motion, contact, leak, smoke…)
sensorSensor (temperature, humidity, air quality…)
vacuumVacuum (as a switch)
buttonButton (as a switch)
sceneScene (as a switch)
selectMode 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
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Costway 5-in-1 climateWorks CloudCapital-C 'Cool' HVAC mode now mapped
Saved copy
Add 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 boxWorks CloudDeep clean, switches and fault sensor added
Saved copy
Summary - 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 2Works CloudSupport added
Saved copy

The original text was already deleted or overwritten when we archived it.

PR #589 · 2025-11
QOTO QT-08W irrigation valveWorks CloudFull support for fdm5kw valve
Saved copy
Follow-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 sensorsWorks CloudSupported via OpenAPI credentials
Saved 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 locksWorks CloudCould not lock/unlock; closed as fixed in latest version
Saved copy
Hello. 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 sensorsWorks CloudTemp/humidity fixed in 4.1.3-beta.2; contact sensor needs workaround
Saved copy
Updated 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 sensorWorks CloudAdded
Saved copy
Summary - 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 conditionerPartly works CloudMissing options and entities even with cloud credentials
Saved 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 kWRequestedVendor x_ codes support PR open
Saved copy
Device 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 bulbRequestedSupport PR closed without merge
Saved copy
Add 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 stars364
Latest versionv4.5.3 (2026-10-14)
Set up in the UIYes
Maintainers@azerty9971
LicenseGPL-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.