Skip to content
Homebridge TestFlight
Tuya

Tuya

homebridge-tuya · v3.1.1

VerifiedLocal

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

DeviceStatusWhat they saidSource
Arlec Grid Connect Smart 9.5W CCT ES GlobeWorksBrightness, color temperature, Adaptive Lighting
Saved 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)WorksUsers got TWLight and RGBTWLight configs working locally
Saved 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 SwitchWorksFan and light control work
Saved 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 BulbWorksColor, brightness, Adaptive Lighting
Saved 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 BulbWorksColor, color temperature, brightness, Adaptive Lighting
Saved 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 conditionerWorksNeeds 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 conditionerWorksCool mode uses COOL phrase by default
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
Ledvance Smart+ SUN@Home LED Recessed SpotlightWorksBrightness, color temperature, Adaptive Lighting
Saved 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 LightWorksBrightness, color temperature, Adaptive Lighting
Saved 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 BulbWorksBrightness, color temperature, Adaptive Lighting
Saved 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 controllerWorksWorks in TW mode
Saved 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 DS03WorksWorks as FanLight type after config help
Saved 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 LampsWorksOn/off and dimming work as SimpleDimmer
Saved copy
Below 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 PlugWorksOn/off works as Outlet
Saved copy
Below 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 BulbWorksBrightness, color temperature, Adaptive Lighting
Saved 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)WorksFixed after report; v3.3 protocol support added
Saved copy
I 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 valveWorksUser confirms Valve accessory works
Saved copy
Below 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 AC27517Partly worksPartial support but protocol is misidentified; new device request open
Saved copy
Describe 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 devicesNot workingReported not working; closed as duplicate
Saved copy
Good 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 motorsNot workingSimpleBlinds and SimpleBlinds2 fail for several users; workaround is other plugins
Saved copy
Checklist [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 StripNot workingLowering brightness turns color red; power state shows off
Saved copy
I 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 workingSet command times out and returns corrupted data
Saved copy
Oeps 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 conditionerRequestedNeeds new device support; works in Home Assistant
Saved copy
Describe 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 HomebridgeYes
Homebridge versions>=0.4.0
Homebridge 2.0No
Node.js>=8.6.0
Settings in Homebridge UIYes
MatterNo
Platform nameTuyaLan
LicenseMIT

Community signals

Downloads a week58
Downloads a month348
GitHub stars438
Open issues144
Closed issues236
Discussions17
Last code push2024-06-28
Latest version3.1.1 (2024-05-03)
First published2018-08-15
Releases72

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