Tuya
homebridge-tuya · v3.1.1
Adds Tuya devices such as lights, fans, heaters and outlets to HomeKit with local control.
What it says it supports
Brands
- Tuya
Devices it names
- Air conditioners
- Air purifiers
- Convectors
- Dehumidifiers
- Dimmers
- Fans
- Garage doors
- Heaters
- Lights
- Oil diffusers
- Outlets
- Switches
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Community wiki lists working local configs for Treatlife, Merkury, Arlec and similar bulbs and plugs; Tuya blinds and unusual devices often fail and need custom configs.
- Works17
- Partly works1
- Not working4
- Requested1
The plugin’s own supported-device list
| Device | Status | What they said | Source |
|---|---|---|---|
| Arlec Grid Connect Smart 9.5W CCT ES Globe | Works | Brightness, color temperature, Adaptive LightingSaved copy… example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't figure out how to get Plug 2 set up yet. Config: [code] Schema/DP's: [code] Fan Fan v2 Fan … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Arlec Grid Connect Smart lighting (batten, PAR38, B22 globes) | Works | Users got TWLight and RGBTWLight configs working locallySaved copy… Great to hear! I must admit I was a little disheartened when I first looked into this a couple months back, with others trying yet not succeeding to get Grid Connect devices to work with local control. The alternative tuya-web bridge works, but the latency was horrible especially when you have a sensor automated. I’ve also enabled an IR receiver from Arlec that I used as a garage door controller without a close sensor. There was some similar code published to support a Kogan garage controller device (within homebridge-tuya) that I adapted to surface in HomeKit. One point to note is that local … Excerpt saved from GitHub on 2026-10-22. | Issue #261 · 2021-04 |
| Aubric Smart WiFi Fan Switch | Works | Fan and light control workSaved copy… example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't figure out how to get Plug 2 set up yet. Config: [code] Schema/DP's: [code] Fan Fan v2 Fan … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| ChangM E16 Chandelier Bulb | Works | Color, brightness, Adaptive LightingSaved copy… TW Mode Tested plugin version: [code] Tested by: @chellmann Link to buy: Amazon Config: [code] Merkury Innovations Dimmable 75W Equivalent Wi-Fi Smart Bulb, Color - BW904 Tested plugin version: [code] Tested by: @clarionite Link to buy: WalMart Capabilities: [X] - Adaptive Lighting [X] - Brightness [X] - Color Temperature Config: [code] Schema/DP's: [code] Treatlife Smart Tunable White Bulb Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] - Adaptive Lighting [X] - Brightness [X] - Color Temperature [ ] - Timer (Use Tuya app) Config: [code] Schema/DP's: … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Feit Smart WiFi Bulb | Works | Color, color temperature, brightness, Adaptive LightingSaved copy… example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't figure out how to get Plug 2 set up yet. Config: [code] Schema/DP's: [code] Fan Fan v2 Fan … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Igenix IG9901WIFI air conditioner | Works | Needs cmdCool set to 'cold'Saved copy… data-points for each outlet (instructions) | |Barely Smart Power Strip|`Outlet`|Smart power strips that don't allow individual control of the outlets| |Air Conditioner|`AirConditioner` 6 |Cooling and heating devices (instructions) | |Heat Convector|`Convector` 7 |Heating panels (instructions) | |Simple Dimmer|`SimpleDimmer` 8 |Dimmer switches with power control (instructions) | |Simple Heater|`SimpleHeater` 9 |Heating solutions with only temperature control (instructions) | |Garage Door|`GarageDoor` 10 |Smart garage doors or garage door openers (instructions) | |Simple Blinds|`SimpleBlinds` … Excerpt saved from GitHub on 2026-10-22. | Wiki: Supported Device Types |
| Kogan KAPRA14WFGA air conditioner | Works | Cool mode uses COOL phrase by defaultSaved copy… data-points for each outlet (instructions) | |Barely Smart Power Strip|`Outlet`|Smart power strips that don't allow individual control of the outlets| |Air Conditioner|`AirConditioner` 6 |Cooling and heating devices (instructions) | |Heat Convector|`Convector` 7 |Heating panels (instructions) | |Simple Dimmer|`SimpleDimmer` 8 |Dimmer switches with power control (instructions) | |Simple Heater|`SimpleHeater` 9 |Heating solutions with only temperature control (instructions) | |Garage Door|`GarageDoor` 10 |Smart garage doors or garage door openers (instructions) | |Simple Blinds|`SimpleBlinds` … Excerpt saved from GitHub on 2026-10-22. | Wiki: Supported Device Types |
| Ledvance Smart+ SUN@Home LED Recessed Spotlight | Works | Brightness, color temperature, Adaptive LightingSaved copy… example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't figure out how to get Plug 2 set up yet. Config: [code] Schema/DP's: [code] Fan Fan v2 Fan … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Merkury Innovations A19 Smart Light | Works | Brightness, color temperature, Adaptive LightingSaved copy… example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't figure out how to get Plug 2 set up yet. Config: [code] Schema/DP's: [code] Fan Fan v2 Fan … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Merkury Innovations Smart Bulb | Works | Brightness, color temperature, Adaptive LightingSaved copy… example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't figure out how to get Plug 2 set up yet. Config: [code] Schema/DP's: [code] Fan Fan v2 Fan … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| MiBoxer / MiLight Tuya WL5 LightStrip controller | Works | Works in TW modeSaved copy… Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't figure out how to get Plug 2 set up yet. Config: [code] Schema/DP's: [code] Fan Fan v2 Fan Light Aubric Smart WiFi Fan Switch Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] Fan Control [X] Light … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Treatlife Ceiling Fan Dimmer Switch DS03 | Works | Works as FanLight type after config helpSaved copy@jlg89 What API version are your DS03 switches running? I think the issue is the API version used at the time it was manufactured. My controllers work fine with TuyaWeb, but even though I'm able to get my older smart plugs working, the DS03 isn't. After doing some troubleshooting, I think the problem is that this plugin hasn't been updated to support the Tuya API 3.4 yet, as referenced in issues #379, #395. I have a smart outlet (using 3.1) working with TuyaLan, but my DS03 (using 3.4) isn't. [TuyaLan] Discovered Test Outlet (012002842c3ae831f872) identified as Outlet (3.1) [Tuya DEBUG] … Excerpt saved from GitHub on 2026-10-22. | Issue #408 · 2023-04 |
| Treatlife Dimmable Smart Plug for Lamps | Works | On/off and dimming work as SimpleDimmerSaved copyBelow is a list of configurations for devices by users of the plugin. Please follow the example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Treatlife Smart Plug | Works | On/off works as OutletSaved copyBelow is a list of configurations for devices by users of the plugin. Please follow the example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Treatlife Smart Tunable White Bulb | Works | Brightness, color temperature, Adaptive LightingSaved copy… Please follow the example template below, and include a link to the device. Air Conditioner: Air Purifier Convector Dehumidifier Dimmer Simple Dimmer Treatlife Dimmable Smart Plug for Lamps Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Capabilities: [X] On/Off [X] Dimming [ ] Timer (Use Tuya app) [ ] Dimming Config (Use Tuya app) Config: [code] Schema/DP's: [code] Treatlife Dimmable Smart Plug DP12 Tested plugin version: [code] Tested by: @benwtf Link to buy: Amazon Notes: Works for plug 1. Can't figure out how to get Plug 2 set up yet. Config: [code] Schema/DP's: … Excerpt saved from GitHub on 2026-10-22. | Wiki: User documented device config |
| Tuya Wi-Fi outlets (v3.3 firmware) | Works | Fixed after report; v3.3 protocol support addedSaved copyI have 6 Tuya switchable outlets that don't seem to work with this plugin. I'm in the process of debugging and analysing the issue. If anyone can help give a direction to look into, than that would be very helpful. Current problem is that the plugin discovers the device, but no state is retrieved and switching also doesn't work. Debug result: [code] Ping-pong result: [code] When switching the device on with the Tuya app i get this result: [code] It looks like the payload can not be parsed, could be encryted or something like that. Excerpt saved from GitHub on 2026-10-22. | Issue #54 · 2019-07 |
| Ucomen Wi-Fi valve | Works | User confirms Valve accessory worksSaved copyBelow are the intercept results from Ucomen Home app. { name: 'Valve', id: 'хххх', key: 'хххх', def: { schema: '[{"mode":"rw","code":"switch_1","name":"\u5f00\u51731","property":{"type":"bool"},"iconname":"icon-dp_power2","id":1,"type":"obj","desc":""},{"mode":"rw","code":"countdown_1","name":"\u5f00\u51731\u5012\u8ba1\u65f6","property":{"unit":"s","min":0,"max":86400,"scale":0,"step":1,"type":"value"},"iconname":"icon-dp_time2","id":9,"type":"obj","desc":""}]', extras: '[{"id":1,"inputStyle":"","inputType":"plain"},{"id":9,"inputStyle":"","inputType":"plain"}]', }, { name: 'Door Detector', … Excerpt saved from GitHub on 2026-10-22. | Issue #82 · 2020-05 |
| LEDVANCE E14 bulb AC27517 | Partly works | Partial support but protocol is misidentified; new device request openSaved copyDescribe your device LEDVANCE E14 Lightbulb AC27517 tunable white, 1000 brightness and color temperature. 470lm. 2700-6500K Partial Support? Yes, but protocol is misidentified Device Schema [code] Excerpt saved from GitHub on 2026-10-22. | Issue #368 · 2022-05 |
| Teckin smart plugs and devices | Not working | Reported not working; closed as duplicateSaved copyGood morning, I'm going to explain my problem to see if someone can help me understand the use of the plugin and the things that happen to me. I will leave everything very well documented so that the failures can be understood. I have the Homebridge installed on a Raspberry Pi 4 with 4Gb ram that has the latest Raspbian OS system. At home all the products I have are from the Teckin brand as an example: Smart plug model: SP22 (measures watts, amps, etc) Simple plug model: SP21 (only On / Off) Led strips model: SL07 (RGB, On / Off, Brightness, etc) I have managed through the video to get all … Excerpt saved from GitHub on 2026-10-22. | Issue #177 · 2021-01 |
| Tuya curtain / blind motors | Not working | SimpleBlinds and SimpleBlinds2 fail for several users; workaround is other pluginsSaved copyChecklist [Y] I have read the common issues wiki page [Y] I have checked to make sure the plugin is up to date Describe the bug I have 3 tuya curtains from 2 bands. One of the curtain is partially working with SimpleBlinds accessory type, other 2 are not working with both SimpleBlinds and SimpleBlinds 2 at all. I also used cmdOn, cmdStop and cmdStop but still nothing works. The one that is partially working is with the following function set Code | Type | Values -- | -- | -- control | Enum | {"range":["open","stop","close"]} percent_control | Integer | … Excerpt saved from GitHub on 2026-10-22. | Issue #180 · 2021-01 |
| Tuya Smart LED Strip | Not working | Lowering brightness turns color red; power state shows offSaved copyI have installed a new LED Strip. I have got it working, everything works fine Colors. Just with the Brightness, the color switches to Red when i try to lower the brightness, not sure what I have done wrong. Scheme [code] My Config [code] Nothing special in logs either to see what is happening `[8/24/2020, 2:08:13 PM] [Tuya] Ready to handle LED Strip (RGBTWLight:3.3) with signature {}` This is what it shows when i do something in Home app [code] Excerpt saved from GitHub on 2026-10-22. | Issue #124 · 2020-08 |
| Tuya Wi-Fi curtain switch (AliExpress) | Not working | Set command times out and returns corrupted dataSaved copyOeps small typo, but the outcome is the same : roets@crt-srv:~$ DEBUG=* tuya-cli get --id 4740565868c63ac585bd --key correctkey --dps 1 [35;1mTuyAPI [0mFinding IP for device 4740565868c63ac585bd [35m+0ms[0m [35;1mTuyAPI [0mReceived UDP message. [35m+62ms[0m [35;1mTuyAPI [0mUDP data: [35m+5ms[0m [35;1mTuyAPI [0m{ ip: [32m'192.168.0.226'[39m, [35;1mTuyAPI [0m gwId: [32m'5587062584f3eb2e4191'[39m, [35;1mTuyAPI [0m active: [33m2[39m, [35;1mTuyAPI [0m ability: [33m0[39m, [35;1mTuyAPI [0m mode: [33m0[39m, [35;1mTuyAPI [0m encrypt: [33mtrue[39m, [35;1mTuyAPI [0m productKey: … Excerpt saved from GitHub on 2026-10-22. | Issue #37 · 2019-01 |
| Ursus Trotter 12000 BTU split air conditioner | Requested | Needs new device support; works in Home AssistantSaved copyDescribe your device A clear and concise description of what your device is, such as accessory type, and product description. Air Conditioner Ursus Trotter 12000 BTU split inverter In the plugin AMoo-Miki/homebridge-tuya-lan was reported but had no response. https://github.com/AMoo-Miki/homebridge-tuya-lan/issues/107 There are screenshots of the app with all the options it allows to control. Reattach the detected schema: [code] Partial Support? Does this device work in any fashion in the plugin? Currently it only shows the current temperature, and internally a confirmation beep sounds but … Excerpt saved from GitHub on 2026-10-22. | Issue #93 · 2020-06 |
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
Local
Local TuyAPI on the LAN with manual DataPoint config
You’ll need
- Device ID and local key
- DataPoint values
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | >=0.4.0 |
| Homebridge 2.0 | No |
| Node.js | >=8.6.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | TuyaLan |
| License | MIT |
Community signals
| Downloads a week | 58 |
|---|---|
| Downloads a month | 348 |
| GitHub stars | 438 |
| Open issues | 144 |
| Closed issues | 236 |
| Discussions | 17 |
| Last code push | 2024-06-28 |
| Latest version | 3.1.1 (2024-05-03) |
| First published | 2018-08-15 |
| Releases | 72 |
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.
Caveats from the README
- Sensors not supported
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- AirPurifier
- AirQualitySensor
- Fan
- GarageDoorOpener
- HeaterCooler
- HumidifierDehumidifier
- HumiditySensor
- Lightbulb
- LockMechanism
- Outlet
- Switch
- TemperatureSensor
- Valve
- WindowCovering
Sources
- npm: https://www.npmjs.com/package/homebridge-tuya
- Source code: https://github.com/iRayanKhan/homebridge-tuya
- Issues: https://github.com/iRayanKhan/homebridge-tuya/issues
- Verified plugins list: https://github.com/homebridge/verified





