Introduction
Control Tuya-based smart devices locally over LAN through OpenBridge and Apple HomeKit.
@nubisco/openbridge-tuya-local-platform communicates directly with Tuya devices on your local network using their Device ID and Local Key -- no cloud dependency required. It runs as a native OpenBridge plugin with full integration into the OpenBridge devices view, telemetry, and controls.
Features
- Local LAN control -- no Tuya cloud needed after initial key extraction
- Wide device support -- 23 device type handlers covering most Tuya-based products
- OpenBridge native integration -- telemetry reporting, device controls, and energy history in the OpenBridge UI
- Apple HomeKit integration -- standalone HAP bridge with QR code pairing
- Adaptive Lighting -- supported on compatible light accessories
- Energy monitoring -- power, voltage, current, and historical consumption tracking on supported devices
- Safety controls -- confirmation dialogs for safety-critical devices (circuit breakers)
- Multi-protocol -- supports Tuya protocol versions 3.1, 3.3, and 3.4
What's Different from Homebridge Tuya Local Platform?
This plugin is forked from @nubisco/homebridge-tuya-local-platform with the following improvements:
- All 23 accessory types report telemetry to the OpenBridge devices view (power state, temperature, humidity, energy data)
- All controllable accessories register controls for the OpenBridge UI (on/off, target temperature, target humidity)
- Native OpenBridge plugin loader with standalone HAP bridge -- no Openbridge required
- Energy history accumulation for circuit breaker monitors (day/month/year views)
- Zod-validated configuration with clear error messages on invalid config
Supported Device Types
| Type ID | Device Category | Description |
|---|---|---|
AirConditioner | Climate | Heat/cool/auto modes with fan speed control |
AirPurifier | Climate | Purifier with fan speed (Breville, Proscenic, Siguro) |
CircuitBreakerMonitor | Energy | Read-only circuit breaker telemetry and safety monitoring |
Convector | Climate | Heater/cooler with LOW/HIGH fan speed |
CustomMultiOutlet | Outlet | Config-driven multi-outlet with custom DP mapping |
Dehumidifier | Climate | Dehumidifier with target humidity and fan speed |
Fan | Fan | Fan with rotation speed control |
FanLight | Fan + Light | Combined fan with lightbulb |
GarageDoor | Garage | Garage door opener with state tracking |
MappedHeatPumpHeater | Climate | Heat pump with virtual room-to-water temperature mapping |
MultiOutlet | Outlet | Multi-outlet with debounced power switching |
OilDiffuser | Humidifier + Light | Oil diffuser with humidifier and RGB light |
Outlet | Outlet | Single outlet with optional energy monitoring |
RGBTWLight | Light | Full RGB + tunable white with adaptive lighting |
RGBTWOutlet | Outlet + Light | Outlet combined with RGBTW light |
SimpleBlinds | Window Covering | Time-based blind position tracking |
SimpleDimmer | Light | Lightbulb with brightness control |
SimpleDimmer2 | Light | Alternative dimmer (DP 3 brightness) |
SimpleHeater | Climate | Basic heater/cooler |
SimpleLight | Light | Basic on/off lightbulb |
Switch | Switch | Multi-switch with debounced power |
TWLight | Light | Tunable white with adaptive lighting |
WaterValve | Valve | Valve with timer support |
See Supported Device Types for detailed configuration parameters and examples for each device.
Requirements
- Node.js >= 20.0.0
- OpenBridge >= 0.5.0
- Tuya device Local Key (see Getting Local Keys)