Skip to content
Homebridge TestFlight
Tuya

Tuya Platform

homebridge-tuya-platform · v1.5.0

VerifiedCloud

Official Tuya Open API plugin for Tuya (Powered by Tuya) devices.

What it says it supports

Brands

  • Tuya

Devices it names

  • Tuya Open API devices

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Supports Tuya categories like lights, switches, outlets, fans, curtains and purifiers; many other categories (sensors, ACs, TRVs, doorbells) were requested via PRs that sat unmerged.

  • Works18
  • Partly works3
  • Requested14

The plugin’s own supported-device list

DeviceStatusWhat they saidSource
Tuya Air purifier categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya breakerWorksSupport merged
Saved copy
Hi @o485 , Glad to receive your PR. Since Breaker (tdq) is not on list of standard instruction sets, please show us the dp functions and device details and we will review SwitchAccessory to see if it is appropriate to add "tdq"

Excerpt saved from GitHub on 2026-10-22.

PR #34 · 2021-06
Tuya Ceiling light categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya contact sensorWorksSupport merged
Saved copy
Added support for Contact Sensors (mcs category).

Excerpt saved from GitHub on 2026-10-22.

PR #84 · 2021-08
Tuya Curtain categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya dimmer (tgq)WorksBrightness-only outdoor dimmers; support merged
Saved copy
I updated from the latest commit and added in support for the category 'tgq.' My devices are outdoor dimmer lights, supporting only brightness. In order to support I had to add in logic for "led_switch_1" and "bright_value_1." It is working in my testing without negatively impacting my 'dj' devices. Please review. If you want to refactor the code in a way that you prefer that is fine too.

Excerpt saved from GitHub on 2026-10-22.

PR #26 · 2021-06
Tuya Fan categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya fan switch (fskg)WorksSupport merged
Saved copy
Hi @slavvka, Thank you very much for your kind feedback. We think of this as a switch category Just need to add the following code: [code]

Excerpt saved from GitHub on 2026-10-22.

PR #49 · 2021-06
Tuya fan with light (fs)WorksLight and brightness added to fan category
Saved copy
Hi @slavvka ,Thank you for your optimization of the code, but the Characteristics in the `FanV2` Service of HomeBridge don't support `On` and `Brightness`, So sorry for that We can't support the light and brightness of the fan

Excerpt saved from GitHub on 2026-10-22.

PR #51 · 2021-06
Tuya Garage door opener categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya Heater categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya Light categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya Outlet categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya Power strip categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya Smoke detector categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya Strip lights categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya Switch categoryWorksCategory listed as supported
Saved copy
First Class Category category code category[en] Small Home Appliances kj AirPurifier qn Heater fs Fan cl Curtain Electrician Category kg Switch cz Outlet pc Power Strip tdq Breaker ckmkzq Garage Door Opener fskg Fan Switch Security & Sensors ywbj Somke Detector mcs Door Window Sensor rqbj Gas Detector jwbj Methane Detector Lighting dj   Light tgq,tgkg Dimmer Switch fwd Ambient light xdd Ceiling Light dd Strip Lights dc String Lights

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Tuya Device Types
Tuya temperature and humidity sensorWorksSupport added via PR after report
Saved copy
Hello there, I've recently added a temperature and humidity sensor on Smart Life/tuya hub. On app, the sensor showed up and worked well, but not loaded on homebridge plugin. Any ideas how to solve it?

Excerpt saved from GitHub on 2026-10-22.

Issue #92 · 2021-08
Tuya blindsPartly worksPosition not reported while moving; fix PR open
Saved copy
1. can't get current blinds percentage at any time 2. no code is called when blinds finished moving = let's estimate moving time and call update function to let homebridge to update the blinds state result

Excerpt saved from GitHub on 2026-10-22.

PR #363 · 2023-07
Tuya light with color temperature (dj)Partly worksColor temperature range mismatch/inverted on some devices
Saved copy
Describe the bug homekit中调节光色时,tuya-homebridge发送的色温范围仅从0(6300K白光)至255(2700K黄光),而设备定义的色温范围在0(黄光)-1000(白光),导致从homekit中只能调节为黄光。 When change color temperature in Homekit, tuya-homebridge send color-temp request with range 0 (which is demonstrated as 6300K white in Homekit) and 255 (which is demonstrated as 2700K warm yellow in Homekit), which the device accepts color temperature with range 0 (2700K warm yellow in tuya app) and 1000 (6300K white in tuya app), hence in homekit, the color could only been adjusted as warm yellow. Expected behavior 设备光色应当能在Homekit中完整调节。 The color temperature should be …

Excerpt saved from GitHub on 2026-10-22.

Issue #136 · 2021-10
Zemismart curtain motorsPartly worksNon-Zigbee models have open/close reversed; Tuya platform plugin suggested
Saved copy
… with the software called “home assistant” running on it. Connected a zigbee antenna like a USB “skyconnect” to the home assistant computer, reconnect the curtain motors to the new zigbee antenna and used HomeKit bridge within home assistant to control my curtains correctly within HomeKit. This is a bit of a long winded was to get it working correctly but I personally like the in house control of these devices, keeping control out of the cloud. Hope this solution works for others.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit thread · 2023-01
LangPlus ST64 smart bulbRequestedBulb not appearing in HomeKit; closed stale
Saved copy
This is the device and for some reason it doesnt pull through into homebridge can you please add this device LangPlus+ ST64 5W Smart LED Bulb, E27 Base Dimmable LED Filament Bulb Compatible with Alexa, Google Home, Edison Light Bulbs with Light Adjustment 2700-6500K https://amzn.eu/d/242T1Po like this: TuyaOpenAPI response: …

Excerpt saved from GitHub on 2026-10-22.

Issue #339 · 2023-01
Moes MS-105B 2-gang dimmerRequestedSupport PR open, not merged
Saved copy
support 2-channel dimmer devices such as Moes MS-105B

Excerpt saved from GitHub on 2026-10-22.

PR #176 · 2021-12
Tesla Smart Dehumidifier XLRequestedDehumidifier support PR closed without merge
Saved copy
Tested on Tesla Smart Dehumidifier XL Supports setting dehumidifier value (with fallback to supported values), child lock, turning on/off, and reports current humidity. The code is super hacked together. I don't hold high hopes that this will get merged any time soon (you know, open source 🫡), but it might be helpful for someone like me. I tried to stay consistent with the codebase and style. Screens

Excerpt saved from GitHub on 2026-10-22.

PR #328 · 2022-12
Tuya air conditioner (kt)RequestedSupport PR open, not merged
Saved copy
hello, does this work ? i have a kt air conditioner but not works :( tried all [7/13/2022, 9:47:41 PM] Homebridge v1.5.0 (HAP v0.10.2) (Homebridge 7696) is running on port 51017. TuyaOpenAPI response: {"result":{"access_token":"c0a1b63a527a45a87440adc4436dc23c","expire_time":7200,"platform_url":"https://openapi.tuyaeu.com","refresh_token":"5bb9c4f8ce78edb0df03e586166230be","uid":"eu1656951052981jZMqh"},"success":true,"t":1657738061997,"tid":"46a0415402dc11edbf837eeb5c0b2a19"} path = /v1.0/iot-01/associated-users/actions/authorized-login TuyaOpenAPI request: method = get, endpoint = …

Excerpt saved from GitHub on 2026-10-22.

PR #150 · 2021-11
Tuya doorbell (wxml)RequestedDoorbell support requested; PR open
Saved copy
[10.03.2023, 20:14:10] [TuyaPlatform] [TuyaOpenMQ] onMessage: topic = cloud/token/in/xxx protocol = 4 message = { "dataId": "xxx", "devId": "xxx", "productKey": "xxx", "status": [ { "10": 1, "code": "doorbell_call", "t": "1678472050", "value": 1 } ] } t = 1678472050 [10.03.2023, 20:14:10] [TuyaPlatform] [TuyaOpenMQ] onMessage: topic = cloud/token/in/xxx protocol = 4 message = { "dataId": "xxx", "devId": "xxx", "productKey": "xxx", "status": [ { "5": "AEQAbwBvAHIAQgBlAGwAbA==", "code": "alarm_message", "t": "1678472050", "value": "AEQAbwBvAHIAQgBlAGwAbA==" } ] } t = 1678472050 INFO from Get …

Excerpt saved from GitHub on 2026-10-22.

PR #348 · 2023-03
Tuya fingerbot and ZigBee curtain switch (clkg)RequestedSupport PR open, not merged
Saved copy
added support for push accessory that turns on and immediately off (for now only included fingerbot, szjqr category) and support for ZigBee curtain switch with percentage control.

Excerpt saved from GitHub on 2026-10-22.

PR #178 · 2021-12
Tuya human presence sensorRequestedSupport PR open, not merged
Saved copy
Reference: https://developer.tuya.com/en/docs/iot/categoryhps?id=Kaiuz42yhn1hs

Excerpt saved from GitHub on 2026-10-22.

PR #247 · 2022-06
Tuya IR remote air conditionerRequestedSupport PR open, not merged
Saved copy
Support smart IR remote with AC device. As of this MR only single device per remote is supported.

Excerpt saved from GitHub on 2026-10-22.

PR #177 · 2021-12
Tuya leak sensor (sj)RequestedSupport PR open, not merged
Saved copy
Added support for device type sj as a LeakSensor

Excerpt saved from GitHub on 2026-10-22.

PR #100 · 2021-08
Show 5 more
DeviceStatusWhat they saidSource
Tuya motion sensorRequestedMotion sensor PR closed without merge
Saved copy
… Tested this one locally and it works. Not sure about the timeout. Could be one minute perhaps. Could not find any documentation about the timeout on the motion sensor.

Excerpt saved from GitHub on 2026-10-22.

PR #170 · 2021-12
Tuya multifunction alarmRequestedSecurity System support PR closed without merge
Saved copy
… support for the Security System accessory on homebridge. Please note lines 187 to 197 on `index.js` I've had to add this `try - catch` block since some Tuya alarms are not properly configured and may not have functions properly assigned, resulting in a useless accessory being added to homebridge. To prevent home app cluttering, I've added this `try - catch` in addition to the `checkAccessoryFunctions` function in `lib/security_system_accessory.js` lines 183 to 188. The rest is a pretty simple and basic implementation following homebridge documentation and tuya documentation. It doesn't manage …

Excerpt saved from GitHub on 2026-10-22.

PR #344 · 2023-02
Tuya TRV thermostat radiator valveRequestedTRV support PR open, not merged
Saved copy
Added Support for Thermo Radiator Valves. Happy to work on other devices if you want, please contact me [email protected]

Excerpt saved from GitHub on 2026-10-22.

PR #183 · 2021-12
Tuya wireless switch (wxkg)RequestedSupport PR closed without merge
Saved copy
Getting this error quite often: (node:912) UnhandledPromiseRejectionWarning: TypeError: Cannot read property 'getCharacteristic' of undefined at WirelessSwitchAccessory.refreshAccessoryServiceIfNeed (/homebridge/node_modules/homebridge-tuya-platform/lib/wirelessswitch_accessory.js:52:12) at WirelessSwitchAccessory.updateState (/homebridge/node_modules/homebridge-tuya-platform/lib/wirelessswitch_accessory.js:72:10) at TuyaPlatform.refreshDeviceStates (/homebridge/node_modules/homebridge-tuya-platform/index.js:193:30) at TuyaPlatform.onMQTTMessage …

Excerpt saved from GitHub on 2026-10-22.

PR #123 · 2021-10
Zemismart ZM25TQ tubular motorRequestedReported unsupported; issue went stale
Saved copy
Device info (please complete the following information, which can be found in log): request path = /v1.0/iot-01/associated-users/devices like this : { "active_time": 1623229189, "biz_type": 18, "category": "cz", "create_time": 1560491945, "icon": "smart/product_icon/cz.png", "id": "aaaaaaaaaaa", "ip": "xxxxxxxxxxxxxxxx", "lat": "30.30286857361191", "local_key": "xxxxxxxxxxxxx", "lon": "120.0639743842656", "model": "", "name": "Living Room Socket", "online": false, "owner_id": "34794909", "product_id": "yfemiswbgjhddhcf", "product_name": "Switch Product", "status": [ { "code": "switch", …

Excerpt saved from GitHub on 2026-10-22.

Issue #130 · 2021-10

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Cloud

Tuya Open API cloud

You’ll need

  • Tuya IoT developer account

Compatibility

Verified by HomebridgeYes
Homebridge versions>=0.2.0
Homebridge 2.0No
Node.js>=0.12.0
Settings in Homebridge UIYes
MatterNo
Platform nameTuyaPlatform
LicenseMIT

Community signals

Downloads a week55
Downloads a month225
GitHub stars396
Open issues0
Closed issues321
Discussions40
Last code push2024-07-21
Latest version1.5.0 (2021-11-03)
First published2021-04-24
Releases28

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

  • AirPurifier
  • ContactSensor
  • Fanv2
  • GarageDoorOpener
  • HeaterCooler
  • LeakSensor
  • Lightbulb
  • Outlet
  • SmokeSensor
  • Switch
  • WindowCovering