Tuya Platform
homebridge-tuya-platform · v1.5.0
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
- Lights
- Outlets
- Switches
- Air Conditioners and Heaters
- Air Purifiers
- Fans
- Windows and Coverings
- Garage Door Openers
- Sensors
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
| Device | Status | What they said | Source |
|---|---|---|---|
| Tuya Air purifier category | Works | Category listed as supportedSaved copyFirst 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 breaker | Works | Support mergedSaved copyHi @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 category | Works | Category listed as supportedSaved copyFirst 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 sensor | Works | Support mergedSaved copyAdded support for Contact Sensors (mcs category). Excerpt saved from GitHub on 2026-10-22. | PR #84 · 2021-08 |
| Tuya Curtain category | Works | Category listed as supportedSaved copyFirst 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) | Works | Brightness-only outdoor dimmers; support mergedSaved copyI 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 category | Works | Category listed as supportedSaved copyFirst 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) | Works | Support mergedSaved copyHi @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) | Works | Light and brightness added to fan categorySaved copyHi @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 category | Works | Category listed as supportedSaved copyFirst 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 category | Works | Category listed as supportedSaved copyFirst 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 category | Works | Category listed as supportedSaved copyFirst 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 category | Works | Category listed as supportedSaved copyFirst 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 category | Works | Category listed as supportedSaved copyFirst 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 category | Works | Category listed as supportedSaved copyFirst 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 category | Works | Category listed as supportedSaved copyFirst 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 category | Works | Category listed as supportedSaved copyFirst 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 sensor | Works | Support added via PR after reportSaved copyHello 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 blinds | Partly works | Position not reported while moving; fix PR openSaved copy1. 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 works | Color temperature range mismatch/inverted on some devicesSaved copyDescribe 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 motors | Partly works | Non-Zigbee models have open/close reversed; Tuya platform plugin suggestedSaved 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 bulb | Requested | Bulb not appearing in HomeKit; closed staleSaved copyThis 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 dimmer | Requested | Support PR open, not mergedSaved copysupport 2-channel dimmer devices such as Moes MS-105B Excerpt saved from GitHub on 2026-10-22. | PR #176 · 2021-12 |
| Tesla Smart Dehumidifier XL | Requested | Dehumidifier support PR closed without mergeSaved copyTested 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) | Requested | Support PR open, not mergedSaved copyhello, 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) | Requested | Doorbell support requested; PR openSaved 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) | Requested | Support PR open, not mergedSaved copyadded 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 sensor | Requested | Support PR open, not mergedSaved copyReference: 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 conditioner | Requested | Support PR open, not mergedSaved copySupport 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) | Requested | Support PR open, not mergedSaved copyAdded support for device type sj as a LeakSensor Excerpt saved from GitHub on 2026-10-22. | PR #100 · 2021-08 |
Show 5 more
| Device | Status | What they said | Source |
|---|---|---|---|
| Tuya motion sensor | Requested | Motion sensor PR closed without mergeSaved 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 alarm | Requested | Security System support PR closed without mergeSaved 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 valve | Requested | TRV support PR open, not mergedSaved copyAdded 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) | Requested | Support PR closed without mergeSaved copyGetting 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 motor | Requested | Reported unsupported; issue went staleSaved copyDevice 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 Homebridge | Yes |
|---|---|
| Homebridge versions | >=0.2.0 |
| Homebridge 2.0 | No |
| Node.js | >=0.12.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | TuyaPlatform |
| License | MIT |
Community signals
| Downloads a week | 55 |
|---|---|
| Downloads a month | 225 |
| GitHub stars | 396 |
| Open issues | 0 |
| Closed issues | 321 |
| Discussions | 40 |
| Last code push | 2024-07-21 |
| Latest version | 1.5.0 (2021-11-03) |
| First published | 2021-04-24 |
| Releases | 28 |
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
Sources
- npm: https://www.npmjs.com/package/homebridge-tuya-platform
- Source code: https://github.com/tuya/tuya-homebridge
- Issues: https://github.com/tuya/tuya-homebridge/issues
- Verified plugins list: https://github.com/homebridge/verified





