Skip to content
Homebridge TestFlight
Tuya, Smart Life

Tuya Web

@homebridge-plugins/homebridge-tuya-web · v1.1.6

VerifiedCloudHomebridge 2.0

Adds Tuya Wi-Fi devices to HomeKit via the Home Assistant style Tuya Web API.

What it says it supports

Brands

  • Tuya
  • Smart Life

Devices it names

  • Tuya Wi-Fi lights
  • outlets
  • fans
  • thermostats
  • covers
  • garage doors

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Works with Tuya/Smart Life devices that the Tuya home-assistant API exposes (lights, switches, covers). Devices missing from that API, like PIR sensors and some sockets, cannot be supported.

  • Works15
  • Partly works17
  • Not working4
  • Requested1
  • Won’t be supported2
DeviceStatusWhat they saidSource
Arlec, Brilliant, Orion, Kmart, Kogan Tuya lights and power boardsWorksMost appear automatically via Smart Life app
Saved copy
Great news is the smart lights and smart power adapters (including power boards) from Bunnings (Arlec, Brilliant, Orion), Kmart and Kogan all work with Homebridge-Tuya-Web, most automatically appear too. I use the Smart Life app instead of each companies individual apps to set up the devices.

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

Reddit comment · 2021-04
BlitzWolf LED stripWorksBrightness and circular color picker appear in HomeKit
Saved copy
I really like the BlitzWolf LED strips...integration into HomeKit through tuya-web plugin

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

Reddit comment · 2019-12
Feit Electric smart bulbsWorksWork via Tuya plugin including color; Smart Life app limits color control
Saved copy
… have these. I almost returned them because I thought they wouldn’t work, but they do work with the homebridge-tuya-web plug-in You can add them to the Smart Life app, but for some reason the app does not allow you to change color or anything other than turn them on/off. However, the Homebridge plugin still lets you control the color

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

Reddit comment · 2021-03
Gosund smart bulbs and plugsWorksSmart Life devices work via tuya-web or 0x5e tuya-platform plugins; tuya-web slow to update
Saved copy
I’m using the @milo526/homebridge-tuya-web mostly because I didn’t want to deal with creating a tuya account, I did try the other ones, but I couldn’t ever get the tuya account to work. It can be a little slow to update the state of the device. It’s NBD for me as I’m (very) slowly replacing all my tuya devices as they fail anyway.

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

Reddit comment · 2024-07
Koogeek power stripWorksWorks when added via Smart Life app instead of Koogeek app; BlitzWolf too
Saved copy
I can confirm that koogeek products (also BlitzWolf which I love due to their esthetics and abilities) work with tuy-web plugin. Although what I did was add koogeek (power strips in my case) to smart life app (even BlitzWolf products) rather than koogeek app. This helps to manage my tuya, koogeek and BlitzWolf in one SMART LIFE APP. This really makes homebridge integration a breeze since only one account is required (of smart life) in homebridge-tuya-web plugin.

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

Reddit comment · 2020-01
Merkury smart switchWorksInstalled via Smart Life method and works under Homebridge
Saved copy
I just installed a Merkury smart switch and installed via the way I described. Working great under Homebridge. But I have to say I like the Treatlife switch much better. I should have just gotten one of those on amazon. It annoys me that the Merkury light stays on all the time.

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

Reddit comment · 2020-02
Silvercrest (Lidl) Zigbee gatewayWorksRebranded Tuya gateway; pair in Smart Life, use Tuya plugin
Saved copy
I find out that lidl bridge is just a rebranded tuya bridge. Reset factory your LIDL Bridge Download Smartlife app (Tuya) Add Zigbee gateway Paire your lamps and stuff Use regular Tuya Web Plugins for Homebridge Worked for me ;)

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

Reddit comment · 2020-12
Smart switch (Smart Life app)WorksSet up in Smart Life app then add via Tuya Web plugin
Saved copy
You can set it up with the smart life app and then use the tuya web plugin to add to homebridge.

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

Reddit comment · 2021-10
Tuya devicesWorksTuyaWeb described as pretty good
Saved copy
I’m using TuyaWeb and it’s pretty good

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

Reddit comment · 2024-02
Tuya devicesWorksAround a dozen devices surface fine without a developer account
Saved copy
I'm using milo's plugin after trying a different one that required a dev account with Tuya's website that felt way over my head. All my devices (around a dozen) are surfacing fine, though I'm having a little trouble with settings for an overhead light that I made a post about just now. I had to surface that one through an Alexa plugin.

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

Reddit comment · 2025-01
Tuya LED strip lightsWorksTuyaWeb better for LED strips; TuyaLan for local control
Saved copy
I use both TuyaWeb and the TuyaLan by Khan. Tuya web is better for LED Strip lights. Everything is setup in Tuya Lan for local control. On the Tuyaweb plug-in I hide all the devices. Unless it works better, then I delete from the TuyaLan plug-in and unhide it in TuyaWeb.

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

Reddit comment · 2020-12
Tuya smart plugWorksCheap Amazon Tuya plug worked with Tuya plugin without flashing
Saved copy
Didn’t need to do this. It worked with the Tuya plugin someone recommended without needing to flash

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

Reddit comment · 2020-07
Tuya smart plugs (Smart Life)WorksThree plugs from Smart Life account appeared after adding login to plugin
Saved copy
I used the “Tuya web” plugin yesterday for the first time. Worked seamlessly. I had an account registered on the Smartlife app, with 3 smart plugs already added. Just added my login to the plugin and rebooted, plugs appeared in accessories list as expected.

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

Reddit comment · 2024-01
Tuya smart plugs/switchesWorksDefault Tuya plugin broke for weeks; Tuya Web plugin works for several users
Saved copy
Honestly I’ve just swapped to the Tuya web plugin with zero issues. The current incumbent plug-in seems broken

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

Reddit comment · 2022-10
XMCosy Wi-Fi lightsWorksTuya-based; works after re-pairing in Tuya app and using its account
Saved copy
Found this thread from a Google search. I can confirm, these are Tuya lights. The XMCosy app is basically just an older, infrequently updated, version of the Tuya app. I paired my XMCosy bistro lights as “string lights.” I’m using a Hoobs certified version of the Tuya Web plugin. It just hit 1.0 two days ago. https://plugins.hoobs.org/plugin/@milo526/homebridge-tuya-web

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

Reddit comment · 2021-01
Aisirer bulbs and Etersky shutter switchesPartly worksBulbs appear; switches did not show until Smart Life account setup issue found
Saved copy
Hey I’m a newbie in this new world of homebridge and I can’t find a plug-in for my (cheap) bulbs and shutter switches I bought of Amazon. I control them both with smart life on an iPhone but I’d love to add them to HomeKit via my raspberry pi 4. Home bridge is running but I can’t find any plugins 🤔. I’ve googled and YouTube for a few hours and I’m more confused now than I was 4h ago hahahah Let me know what other infos I could provide and thanks for the help already Bulbs: Aisirer Switch: Etersky

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

Reddit thread · 2020-12
Amantii Bespoke fireplacePartly worksDirect Tuya plugin shows as non-working thermostat; works via Tuya WiFi relay on/off
Saved copy
Yes! I actually just got done setting this up earlier today. Blew my mind when I scrolled and saw your post. I have a Tuya 2 channel Wi-Fi relay for my fireplace (one for fireplace, one for a fan). I am using the “TuyaWebPlatform @milo526/homebridge-tuya-web v1.1.2” and my device configured through the Smart Life app (I see Tuya has an app now as well). The plug-in requires the virtual device ID which you can locate in the Smart Life app. Hope this info helps! Edit: to clarify, I’ve had luck getting the relay working with homebridge, as for wiring to your particular fireplace, I might not be …

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

Reddit comment · 2022-06
Deta Grid Connect touch light switch (single and quad gang)Partly worksAdded via TuyaSmart app then Tuya Web plugin; works with some hassle
Saved copy
I've added a Deta (bought at Bunnings) single and quad gang touch light switch to my smart home. First I added it to the TuyaSmart app. Then I installed the Tuya Web plugin - the config settings were my TuyaSmart app username and password. The only hassle I've had is that the I can turn the lights on/off via Siri and Home app with no problems but when I turn the light switch on/off at the actual switch itself, the status does not show on the Home app i.e. I manually turn the light on but the Home app shows it as off. The second issue is that the Tuya Web plugin is not recognising the fan …

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

Reddit comment · 2021-05
eFamilyCloud WiFi plug (Tuya-based)Partly worksTuya-based; re-add devices to TuyaSmart/Smart Life app; poster could not get them to appear
Saved copy
Yeah, anything that uses the eFamilyCloud (or TuyaSmart or Smart Life) app are based on Tuya cloud API. I think you’ll want either of these to get started: https://github.com/AMoo-Miki/homebridge-tuya-lan Or https://github.com/basdelfos/homebridge-tuya-web You can also flash it with Tasmota firmware to remove all traces of Tuya and stop it from communicating with Chinese servers: https://github.com/ct-Open-Source/tuya-convert Tuya-web is easier to use and it just works for me. It uses your existing Tuya account details and works with the basic devices (plugs and lights/dimmers). Tuya-lan …

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

Reddit thread · 2019-12
Feit BPA800 color bulbsPartly worksWork via Tuya account and plugin, but flaky and color picking is clunky
Saved copy
I've got lots of these (and other Feit) bulbs. Download the Tuya app on your phone, create a free account, add the bulbs there, install the Tuya Web plugin on homebridge and add the bulbs in the plugin config. They work...OK. They've flaked on me here and there and Homekit's color/temperature chooser is truly awful, but for the price, they work great for my needs. Oh, and the Tuya app is going to tell you the version of the app doesn't support the bulb. You can ignore that since you'll be using Homekit. EDIT: I just realized that maybe you have some bulbs with different/newer guts than mine, …

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

Reddit comment · 2021-10
Lumary LED light stripPartly worksTuya-based; suggested to work with tuya-web plugin, original brand plugins did not
Saved copy
It seems like this product is based on tuya. Try adding it to the tuya app and see if you can get it to work with one of the tuya plugins It should work with my homebridge-tuya-web plugin; search for @milo526/homebridge-tuya-web

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

Reddit comment · 2020-10
Teckin Tuya RGB bulbPartly worksOn/off works; preset colours wrong, colour wheel fine; tuya-lan suggested instead
Saved copy
Indeed...since iOS 13 tuya bulbs are behaving like this. Also I have observed the same phenomenon in magichome bulbs as well. If you use the color wheel (pressing edit on preset color circles) the things behave as they should. It’s the preset colors that give trouble. The HomeKit model and tuya api are at odds on the color model - RGB HSV. I modified the tuya-web plugin to map the six scenes in tuya app to preset circles in HomeKit. The preset circles do not remember last value you set them to. Sometimes they send the preset color value but mostly they send a setColorTemprature command to …

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

Reddit comment · 2020-04
Teckin Tuya RGBW bulbs and stripsPartly worksWork well in tuya-web; preset colours wrong, colour wheel works
Saved copy
Sorry to hear that. I have number of tuya rgbw bulbs and strips and they have been working great with tuya-web plugin. The preset color circles don’t work properly but the color wheel works perfectly. In your case, I highly recommend using official homebridge installation. HOOBS has their own layer on top of homebridge and I have seen similar issues.

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

Reddit comment · 2020-05
Treatlife Tuya bulbsPartly worksWarm white shows bluish and cool white blue; colour mapping wrong in HomeKit
Saved copy
Hi everyone, Just set up my Homebridge and a few Tuya bulbs. I'm having major issues setting light color through the Homekit interface and through Siri. Requesting warm white turns the bulb a bluish hue, and cool white a full blue. Is there any calibration I could do to get these bulbs to output corrct colors? I'm using the official Tuya plugin if that matters at all. Thank you!

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

Reddit thread · 2021-05
Tuya colour bulbs (Action shop)Partly worksWorks but odd behaviour setting brightness; colour handling flaky since firmware change
Saved copy
Yes it does...and easiest integration with homebridge is through cloud base ie tuya-web plugin. I have 6 tuya color rgbw bulbs and they works fine. Although they suffer from same problem as other bulbs ie HomeKit sometimes misinterprets color values. The OP has the deviceID and Key (that should be blurred) and controlling locally. There are two issues with this approach and probably cause of OP problems: NEW tuya bulbs or devices firmware do not respond to devicedID/key local commands and could generate weird problems like OP has described. Old devices firmware (prior to 2018) did work all …

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

Reddit thread · 2020-01
Tuya devices via homebridge-tuya-webPartly worksAPI errors in logs; devices still controllable; fork fixed it (2 users)
Saved copy
Uninstall the original plugin and install this fork: https://www.npmjs.com/package/homebridge-tuya-web-beta It works for me, no errors.

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

Reddit comment · 2020-06
Tuya dimmable light bulbsPartly worksBrightness warnings since Tuya raised max to 1000; fix PR proposed
Saved copy
[12/9/2021, 7:07:26 AM] Homebridge v1.3.8 (HAP v0.9.7) (Homebridge MBCC) is running on port 51709. [12/9/2021, 7:07:29 AM] [TuyaWebPlatform] Sending HTTP GET request to /homeassistant/skill - Header: {"name":"Discovery","namespace":"discovery","payloadVersion":1}. [12/9/2021, 7:07:30 AM] [TuyaWebPlatform] Device type for "Den front" is overruled in config from light to: "dimmer" [12/9/2021, 7:07:30 AM] [TuyaWebPlatform] Device type for "Ensuite" is overruled in config from light to: "dimmer" [12/9/2021, 7:07:30 AM] [TuyaWebPlatform] Device type for "Stairs" is overruled in config from light …

Excerpt saved from GitHub on 2026-10-22.

Issue #370 · 2021-12
Tuya dimmerPartly worksDimmer shows as colour light; device_type defaults config would not validate
Saved copy
… credentials in MyQ2... Anyway, all you really need is the "defaults" parameter after the "options". Your config file doesn't show an ID for the device in Tuya. Do you have the ID of the device? To find the ID of the device, you can follow the original TuyAPI method or the Tuya-Lan method. Never tried the Tuya-Lan method myself though... If the ID is set and the device_type is set to dimmer, it should work. { "platform": "TuyaWebPlatform", "name": "TuyaWebPlatform", "options": { "username": "Private", "password": "Private", "countryCode": "1", "platform": "tuya", "pollingInterval": 20 }, …

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

Reddit thread · 2020-01
Tuya Smart Life window shutters/coversPartly worksCovers work poorly; status needs app reload twice, STOP option missing
Saved copy
Hello, I use your plugin for shutters from SmartLife. It works fine, except that I have to reload the Homekit app twice to get the right status of the different devices. Wanting the "STOP" option, I took your version 8.0.0, but I don't have it even with the option activated. I don't know if this is a bug. But hey. I thought you would have used the options available there for alarms with 3/4 predefined options: "Open", "Pause", "(half)", "Close". I turned to a fix proposed by bSr43 ( https://github.com/bsr43/homebridge-tuya-web ) for the status of the shutters, and it works really well, I …

Excerpt saved from GitHub on 2026-10-22.

Issue #171 · 2021-01
Tuya smart RGB ceiling lampPartly worksWeb plugin only on/off; Tuya Smartlamp plugin suggested for full control
Saved copy
I may have a tip for you too. Have you tried the Homebridge Tuya Smartlamp Plugin with your lamp. Because I could connect my lamp to the Tuya Web Plugin, but I could only turn the light on or off. So I take a look at the other plugins and find out that the other Plugin could work with me lamp.

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

Reddit comment · 2020-01
Show 9 more
DeviceStatusWhat they saidSource
Tuya WiFi curtain switchPartly worksShutter switches work only as dimmers, not blinds
Saved copy
Hey everybody. Can someone help me setup my 3 tuya devices ? I've got a wifi switch and two curtain wifi switches.. The only plugin that worked was tuya wifi but only for the wifi switch... I've installed both smart life app and tuya smart app. Any help will be appreciated.. thanks

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

Reddit thread · 2019-12
Tuya WiFi devicesPartly worksLogin error fixed by choosing Tuya Smart platform; intermittent errors reported
Saved copy
… anyone else experiencing this issue, I fixed my login problem by selecting the correct Platform in the configuration 🤦‍♂️ Turns out I needed to select "Tuya Smart" rather than "Smart Life" for my particular appliance in my region (I'm in the UK, and despite the Amazon listing confusing the issue by claiming it was the Smart Life app I needed to use).

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

Reddit comment · 2020-06
Teckin strip lightNot workingPlugs work but strip light not recognised
Saved copy
I'm new to all of the Pi, HOOBS and Tuya and am struggling! Am using Tuya Web and have four smart outlets/plugs working as expected but cannot get a Teckin strip light recognised, let alone working. Outlests/Plugs are configured in the same way as this { "name": "My Bed Light", "device\_type": "RGBTWLight", "manufacturer": "Teckin", "model": "Smart Music Strip Light", "id": "bfcacnnnnnn07a03a7bmer", "key": "a571nnnnnn08b434" }, ​ Any help gratefully received. ​ tx

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

Reddit comment · 2020-12
Tuya devices via TuyaWebNot workingAbout 30 accessories often show Not Responding; flashing Tasmota advised
Saved copy
Seriously - forget tuyaweb. Awful. Much better option - flash all the Tuya devices with Tasmota (https://tasmota.github.io/docs/Getting-Started/), and they will all work perfectly, forever.

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

Reddit thread · 2021-02
Tuya Zigbee devicesNot workingWeb plugin auth failed; local plugins do not expose Zigbee devices
Saved copy
Ahhhh gotcha, I was assuming you were using some kind of HomeKit-native zigbee hub with the Tuya devices. It’s possible the Tuya hub can only be communicated with from the cloud.

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

Reddit thread · 2026-03
Tuya/Smart Life smart wall socketNot workingNot picked up by web plugin; LAN plugin with local key also failed
Saved copy
Greetings from UK. I bought one of these, and installed it fine in my smart life app but the tuya web plugin doesn't pick it up. I also tried extracting its local key and doing it with the tuya lan plugin but that doesn't work either. Anyone had any success getting these things to appear in homekit? https://preview.redd.it/77q6fvq4wvv61.png?width=1172&format=png&auto=webp&s=af5e22be555bda726cdba262554cf72151236758

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

Reddit thread · 2021-04
Tuya smart water valveRequestedValve device type not available in HomeKit; help wanted, still open
Saved copy
… below is an abbreviated form of the script's results. What I need (and believe others are asking for) is support for a manipulator arm that turns off the valve. The water valve operates like a switch that's either on or off. In the Tuya Development Platform, it is listed under Electrical > Valve Pump > Smart Manipulator Arm. Two other related types in their API are "Water Valve Controller" and "Indoor Smart Water Valve." I just emailed Tuya support to ask them to add support to /homeassistant for valves. Today, the only way to identify these devices would be to inspect the icon returned. …

Excerpt saved from GitHub on 2026-10-22.

Issue #241 · 2021-03
Tuya PIR / human movement sensorWon’t be supportedMaintainer: device type not supported by the Tuya API the plugin uses
Saved copy
It would be great if the plugin would support human movement sensors. Device type PIR sensors (Human movement sensor) Device information general device support not an individual device

Excerpt saved from GitHub on 2026-10-22.

Issue #409 · 2022-02
Tuya smart socket (unlisted)Won’t be supportedDevice not in Tuya home-assistant API discovery list, so plugin cannot see it
Saved copy
I recently purchased a Tuya Smart Socket. I went though your guidance, ran the script. The device was not in the list. I sent the below email to Tuya and get the below response Email to Tuya Hello, I recently purchased this device and it is not supported in your home assistant API. I discovered this using the script shown on this GitHub page: https://github.com/milo526/homebridge-tuya-web The device is shown below: Type: dj Device ID: 20238250bcff4d1f437a Tuya Response Dear user, Thank you for contacting support team. Please note for the external plugins, we do not maintain currently. We are …

Excerpt saved from GitHub on 2026-10-22.

Issue #507 · 2022-12

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 Web cloud API

You’ll need

  • Tuya or Smart Life account

Compatibility

Verified by HomebridgeYes
Homebridge versions^1.11.4 || ^2.0.0
Homebridge 2.0Yes
Node.js^22.12.0 || ^24.0.0 || ^26.0.0
Settings in Homebridge UIYes
MatterNo
Platform nameTuyaWebPlatform
LicenseMIT

Community signals

Downloads a week38
Downloads a month163
GitHub stars235
Open issues11
Closed issues414
Discussions128
Last code push2026-10-04
Latest version1.1.6 (2026-07-31)
First published2026-07-31
Releases1

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

  • Needs stable internet connection

HomeKit services in its code

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

  • Fanv2
  • GarageDoorOpener
  • Lightbulb
  • Outlet
  • Switch
  • TemperatureSensor
  • Thermostat
  • Window
  • WindowCovering