@nubisco/openbridge-tuya-local-platform
v1.5.1
Published
OpenBridge plugin to control Tuya devices locally over LAN — supports both native (plugins[]) and Openbridge-compat (platforms[]) loading modes
Downloads
828
Readme
Openbridge Tuya Local Platform
Control Tuya smart devices locally over LAN through Apple HomeKit. No cloud, no latency.
Table of Contents
Quick Start
Option 1 — Openbridge UI (recommended):
- Open the Openbridge web UI and navigate to the Plugins tab.
- Search for
@nubisco/openbridge-tuya-local-platformand click Install. - Use the plugin's settings form to add your devices, then restart Openbridge.
Option 2 — Command line:
npm install -g @nubisco/openbridge-tuya-local-platformAdd to your Openbridge config.json:
{
"platforms": [
{
"platform": "TuyaLocalPlatform",
"devices": [
{
"name": "My Light",
"type": "SimpleLight",
"id": "<device-id>",
"key": "<local-key>"
}
]
}
]
}Need your device credentials? See the Getting Local Keys guide.
Why Local Control?
Tuya's cloud relies on remote servers — any outage, policy change, or internet disruption can leave your automations unresponsive. This plugin talks directly to your devices over your LAN using the Tuya protocol (v3.1, v3.3, v3.4):
- Works offline — your smart home keeps working even when the internet is down
- Instant response — no round-trip to the cloud; commands execute in milliseconds
- No subscription — zero dependency on Tuya's infrastructure or account
Features
- Local LAN Control — Communicates directly with devices; no cloud, no internet dependency
- 23 Device Types — Outlets, lights, dimmers, fans, sensors, climate control, and more
- Adaptive Lighting — HomeKit Adaptive Lighting on compatible tunable white and RGBTW accessories
- Energy Monitoring — Real-time voltage, current, and power readings on supported devices
- Automatic Discovery — UDP broadcast discovery finds devices on your local network automatically
- Flexible Configuration — Override DataPoints (DPs) and tune device behavior per accessory
- Multi-protocol Support — Full encryption and authentication for Tuya protocol v3.1, v3.3, and v3.4
- TypeScript — Fully typed codebase with comprehensive test coverage
Supported Devices
| Device | Type key |
| :------------------------------------ | :---------------------: |
| Air Conditioner | AirConditioner |
| Air Purifier | AirPurifier |
| Circuit Breaker Monitor (read-only) | CircuitBreakerMonitor |
| Heat Convector | Convector |
| Non-sequential Power Strip | CustomMultiOutlet |
| Dehumidifier | Dehumidifier |
| Smart Fan Regulator | Fan |
| Smart Fan with Light | FanLight |
| Garage Door | GarageDoor |
| Mapped Heat Pump Heater | MappedHeatPumpHeater |
| Smart Power Strip | MultiOutlet |
| Oil Diffuser | OilDiffuser |
| Smart Plug | Outlet |
| Smart Plug w/ Color Lights | RGBTWOutlet |
| White and Color Light Bulb | RGBTWLight |
| Simple Blinds | SimpleBlinds |
| Simple Dimmer | SimpleDimmer |
| Simple Dimmer 2 | SimpleDimmer2 |
| Simple Heater | SimpleHeater |
| Simple Light Bulb | SimpleLight |
| Multi-Switch | Switch |
| Tunable White Light Bulb | TWLight |
| Water Valve | WaterValve |
The
typevalue is case-insensitive."SimpleLight","simplelight", and"SIMPLELIGHT"all work.
Full per-device configuration details and DataPoint overrides are covered in the Supported Device Types docs.
Documentation
Full documentation is available at docs.nubisco.io/openbridge-tuya-local-platform, including:
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for development setup, coding standards, and pull request guidelines.
Security
For security vulnerabilities, please see SECURITY.md for responsible disclosure procedures.
Support this project
If this plugin helps your Openbridge setup, consider sponsoring development. Maintaining device integrations, testing hardware, and providing support takes significant time — GitHub Sponsors helps ensure long-term maintenance.
