Skip to content
Homebridge TestFlight
Tuya, Smart Life

Tuya (QR login)

homebridge-tuya-without-developer-account · v1.1.1

CloudHomebridge 2.0

Adds Tuya and Smart Life devices to HomeKit using QR cloud authentication without a developer account.

What it says it supports

Brands

  • Tuya
  • Smart Life

Devices it names

  • Pet feeder
  • blinds
  • AC
  • multi-channel switches
  • outlets

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Supports many Tuya categories (lights, switches, sockets, fans, blinds) through a doc list; the maintainer fixes data-point mappings quickly when users report models.

  • Works6
  • Partly works1
  • Won’t be supported1

The plugin’s own supported-device list

DeviceStatusWhat they saidSource
Tuya 6-speed fanWorksFan speed showed 1-5 then wrong percent; fixed after update
Saved copy
Hi Kosztyk, My fans have 6 speeds. In Apple HomeKit, it shows 1%, 2%, 3%, 4%, and 5%. The 6 setting is missing. Is this something that can be fixed? Here are the logs when I switch from 1 to 6. When my fan is set to 6, HomeKit shows 100%. [14/08/2026, 09:46:22] [Tuya without developer account] [TuyaHADeviceManager] [TuyaHASharingMQ] Tuya HA MQTT message: {"protocol":4,"data":{"devId":"eb8bf064353e1f93d6k9vo","dataId":"ac2a77d5-3361-486a-86aa-f13345e7b0dd","productKey":"atfenlerda169ygw","status":[{"62":1,"code":"fan_speed","t":1786715182595,"value":1}]},"t":1786715182933} [14/08/2026, …

Excerpt saved from GitHub on 2026-10-22.

Issue #10 · 2026-08
Tuya blinds/curtain motorWorksStop button requested; tap-to-stop behavior added in latest version
Saved copy
Right now, you can either click to open/close all the way or choose a specific location using the slder (pic 1). It would be great to have a button to stop it at anytime. I attached an image (pic 2) of how it works for my other device as example

Excerpt saved from GitHub on 2026-10-22.

Issue #8 · 2026-08
Tuya DP10 Smart dimmer plugWorksShowed Not Supported; fixed by mapping bright_value_v2 and switch_led
Saved copy
Thanks, the screenshots help. The Home app showing Not Supported means the plugin is not exposing this dimmer plug as a valid HomeKit Lightbulb service. The device model is shown as DP10 Smart dimmer Plug, so I need to add/fix the Tuya DP mapping for this type of dimmer plug. Basic lights and outlets working means QR auth and normal command sending are OK; this is specifically a dimmer-plug mapping issue. Can you please send me the Homebridge startup log lines around `Patio Lights`? You can get them with: [code] If possible, also send the cached Tuya device JSON for that device, because I …

Excerpt saved from GitHub on 2026-10-22.

Issue #2 · 2026-05
Tuya light, strip, ceiling light, dimmerWorksListed as supported Lightbulb categories
Saved copy
Supported Tuya Devices First-class category name, sedond-class category name, category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. Lighting | Name | Name (zh) | Code | Homebridge Service | Supported | Links | | ---- | ---- | ---- | ---- | ---- | ---- | | Light | 光源 | dj dsd | Lightbulb | ✅ | Documentation | | Ceiling Light | 吸顶灯 | xdd | Lightbulb | ✅ | Documentation | | Ambiance Light | 氛围灯 | fwd | Lightbulb | ✅ | Documentation | | String Lights | 灯串 | dc | Lightbulb | ✅ | …

Excerpt saved from GitHub on 2026-10-22.

Docs: SUPPORTED_DEVICES.md
Tuya qxj weather station sensorWorksPR adds temp_current and humidity_value datapoints; closed
Saved copy
Thanks for the contribution and for testing this on a real qxj device. The underlying idea is good and I do want to support these datapoints, but I’d like a couple of changes before merging because the current matching is slightly too broad and could produce incorrect HomeKit values on other Tuya devices. The first issue is this condition: schema.code.startsWith('temp_current') That will correctly match: temp_current temp_current_external but it can also match other Tuya datapoints that begin with the same prefix, for example: temp_current_f which is typically a Fahrenheit temperature …

Excerpt saved from GitHub on 2026-10-22.

PR #11 · 2026-09
Tuya switch, socket, power stripWorksListed as supported Switch/Outlet categories
Saved copy
Supported Tuya Devices First-class category name, sedond-class category name, category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. Lighting | Name | Name (zh) | Code | Homebridge Service | Supported | Links | | ---- | ---- | ---- | ---- | ---- | ---- | | Light | 光源 | dj dsd | Lightbulb | ✅ | Documentation | | Ceiling Light | 吸顶灯 | xdd | Lightbulb | ✅ | Documentation | | Ambiance Light | 氛围灯 | fwd | Lightbulb | ✅ | Documentation | | String Lights | 灯串 | dc | Lightbulb | ✅ | …

Excerpt saved from GitHub on 2026-10-22.

Docs: SUPPORTED_DEVICES.md
Tuya IR air conditioner remote (infrared_ac)Partly worksShows empty accessory in QR mode; open PR adds local IR hub state
Saved copy
Summary In QR mode, IR AC remotes (`infrared_ac`) currently show up as an empty accessory. The QR cloud has no `remote_keys` and no IR Control Hub API, so `IRAirConditionerAccessory` gets no modes and no temperature range, and it can't send commands. This PR adds `IRAirConditionerHAAccessory`, which extends `IRAirConditionerAccessory`: Commands: sent with the remote's QR functions `PowerOn` / `PowerOff` / `M` / `T` / `F` through `/v1.1/m/thing/{id}/commands`. Only changed settings are sent, one function per request, because the QR cloud rejects several IR AC functions in one request (`1109`). …

Excerpt saved from GitHub on 2026-10-22.

PR #16 · 2026-10
Tuya remote control (ykq)Won’t be supportedCategory listed without a supported mark
Saved copy
Supported Tuya Devices First-class category name, sedond-class category name, category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. Lighting | Name | Name (zh) | Code | Homebridge Service | Supported | Links | | ---- | ---- | ---- | ---- | ---- | ---- | | Light | 光源 | dj dsd | Lightbulb | ✅ | Documentation | | Ceiling Light | 吸顶灯 | xdd | Lightbulb | ✅ | Documentation | | Ambiance Light | 氛围灯 | fwd | Lightbulb | ✅ | Documentation | | String Lights | 灯串 | dc | Lightbulb | ✅ | …

Excerpt saved from GitHub on 2026-10-22.

Docs: SUPPORTED_DEVICES.md

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 cloud via QR authentication

You’ll need

  • Tuya or Smart Life app account

Compatibility

Verified by HomebridgeNo
Homebridge versions^1.8.0 || ^2.0.0-beta.0
Homebridge 2.0Yes
Node.js^20 || ^22 || ^24 || ^25
Settings in Homebridge UIYes
MatterNo
Platform nameTuyaNoDeveloperAccount
LicenseMIT

Community signals

Downloads a week286
Downloads a month1,374
GitHub stars8
Open issues1
Closed issues13
Last code push2026-10-22
Latest version1.1.1 (2026-10-22)
First published2026-05-17
Releases54

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

  • No native Pet Feeder tile in Apple Home

HomeKit services in its code

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

  • AirPurifier
  • AirQualitySensor
  • Battery
  • CarbonDioxideSensor
  • CarbonMonoxideSensor
  • ConfiguredName
  • ContactSensor
  • Doorbell
  • Fan
  • Fanv2
  • GarageDoorOpener
  • HeaterCooler
  • HumidifierDehumidifier
  • HumiditySensor
  • LeakSensor
  • LightSensor
  • Lightbulb
  • LockMechanism
  • MotionSensor
  • Name
  • OccupancySensor
  • Outlet
  • SecuritySystem
  • SmokeSensor
  • StatelessProgrammableSwitch
  • Switch
  • TemperatureSensor
  • Thermostat
  • Valve
  • Window
  • WindowCovering