ProperGoodTuya

A Home Assistant custom integration for local handling of Tuya-based devices. Forked from rospogrigio/localtuya with active maintenance, bug fixes for latest Home Assistant versions, and expanded device support.

• Status updates via push (not polling) -- fast, even when manually operated
• Tuya IoT Cloud API support for automatic local_key retrieval
• Tuya protocols 3.1 through 3.5 (including AES-GCM encryption for 3.5)

Supported Devices

Switches, Lights, Covers, Fans, Climates, Vacuums, Sensors, Binary Sensors, Numbers, Selects -- plus energy monitoring for compatible devices.

See SUPPORTED_DEVICES.md for the full list including DP mappings and planned device support (water quality monitors, hydroponics controllers, pet feeders, and more).

Quick Start

1. Install via HACS or manually copy the custom_components/localtuya folder to your HA config
2. Add the integration from Settings > Integrations > + Add Integration > ProperGoodTuya
3. Configure your Tuya IoT Cloud API credentials (optional but recommended)
4. Add your devices

See GETTING_STARTED.md for detailed installation, Cloud API setup, and device configuration instructions.

Key Notes

• The Cloud API account is not mandatory but is strongly recommended for easy local_key retrieval and auto-update after re-pairing devices. Cloud API calls only happen at startup and when a key update is needed.
• Do not declare anything as "tuya" (e.g. switch.tuya) -- this launches Home Assistant's built-in cloud-based Tuya integration instead of ProperGoodTuya.
• If blocking device internet access, you must also block DNS requests. See GETTING_STARTED.md for details.

Debugging

Enable debug logs by adding this to your configuration.yaml:

logger:
  default: warning
  logs:
    custom_components.localtuya: debug
    custom_components.localtuya.pytuya: debug

Then edit the device showing problems and check "Enable debugging for this device".