@nubisco/homebridge-tuya-local-platform
v1.4.1
Published
Homebridge plugin to control Tuya devices locally over LAN
Downloads
238
Readme
Homebridge Tuya Local Platform
Control Tuya smart devices locally over LAN through Apple HomeKit. No cloud, no latency.
Table of Contents
Quick Start
Option 1 — Homebridge UI (recommended):
- Open the Homebridge web UI and navigate to the Plugins tab.
- Search for
@nubisco/homebridge-tuya-local-platformand click Install. - Use the plugin's settings form to add your devices, then restart Homebridge.
Option 2 — Command line:
npm install -g @nubisco/homebridge-tuya-local-platformAdd to your Homebridge 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/homebridge-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 Homebridge setup, consider sponsoring development. Maintaining device integrations, testing hardware, and providing support takes significant time — GitHub Sponsors helps ensure long-term maintenance.
