Local Tuya - Control Tuya devices locally (Fork from localtuya)

I am running the below

LocalTuya - Version 2025.10.0

Installation method -Home Assistant OS
Core -2025.10.3
Supervisor - 2025.10.0
Operating System - 16.2
Frontend - 20251001.4

No problems here, what do your logs say?LocalTuya
Version 2025.10.0

logs, i would guess a enpoint not connecting or crapping out. Log will tell you more

Logger: homeassistant.helpers.translation
Source: helpers/translation.py:226
First occurred: 9:54:33 AM (1 occurrence)
Last logged: 9:54:33 AM

Failed to load integration for translation: Integration ‘localtuya’ not found.

  1. Verify the files exist and are named correctly
  • Path must be exactly:
    /config/custom_components/localtuya/
    and that folder must contain manifest.json with "domain": "localtuya".
  • Common mistake: folder named localtuya-homeassistant or nested incorrectly.
  1. Repair via HACS
  • HACS → Integrations → LocalTuya → ••• → Reinstall (or Repair) → Restart Home Assistant (full restart, not just reload).
  1. If it’s disabled or corrupted
  • Settings → Devices & Services → LocalTuya → Enable (or Remove then re-add) → Restart HA.

Hi,

I just figure out a weird issue don’t ask me how I did that … I have 2 version of local Tuya installed 2025.10 and 5.2.2.

I know that my device are setup with 2025.10 since when I go to my integration I can see the version where all my Tuya device are

My issue is if I delete the 5.2.2 all my device stop working.

Do you guys have an idea of what I can do ?

This is how I originally installed this fork. I recommend delete rospogrigio and ensure the xZetsubou fork is installed. Ignore the HACS Warning and restart.

I reinstalled now local tuya starts up but I get
Logger: custom_components.localtuya.core.cloud_api
Source: custom_components/localtuya/core/cloud_api.py:350
integration: LocalTuya (documentation, issues)
First occurred: 11:38:13 AM (1 occurrence)
Last logged: 11:38:13 AM
[az1…Fhp] Cloud API connection failed: Error 28841002: No permissions. Your subscription to cloud development plan has expired.

Except when I go to the tuya developer site everything seems fine.

Cloud> Cloud Services>

Check for expired subscriptions, there should be an extend for free option there somewhere.

If not maybe try re-enter your Authorisation Key.

Cloud> Project Management> Open Project> Overview or Authorization.

Re-Enter these details into the Local Tuya Integration. Manage Cloud API account

Hi, I’m trying to add the vertical swing control into the climate entity of the wall mounted heater, but the configuration device_name:friendly_name of the (Optional) Vertical swing options didn’t work for my device

As you can see, the DP wants a boolean value, but when i try to set the integration, it automatically changed the config in this way

And the control doesn’t work, how can I resolve this?

Also, is it possible to have the turn on/turn off with a DP and the modes in another DP, but all of this into the climate entity?

What is the best way to go about creating a new device type to create a single device with multiple entities assigned to it of different types. I have a towel warmer that doesn’t quite fit the climate aspect because it needs a time and start command as well the on/off switch.

I have the output from IOT platform showing all possible DP IDs and values accepted, unsure the best way to map this into a new device. Should it be through a yaml template config? If so, is there an example from say a dehumidifier that has multiple entities? The light ones seem like they’re drastically different than what this setup would be.

Here’s the IOT platform output.

{
  "result": {
    "category": "mjj",
    "functions": [
      {
        "code": "switch",
        "dp_id": 1,
        "type": "Boolean",
        "values": "{}"
      },
      {
        "code": "temp_unit_convert",
        "dp_id": 9,
        "type": "Enum",
        "values": "{\"range\":[\"c\",\"f\"]}"
      }
    ],
    "lang_config": {},
    "status": [
      {
        "code": "switch",
        "dp_id": 1,
        "type": "Boolean",
        "values": "{}"
      },
      {
        "code": "temp_current",
        "dp_id": 3,
        "type": "Integer",
        "values": "{\"unit\":\"℃\",\"min\":0,\"max\":255,\"scale\":0,\"step\":1}"
      },
      {
        "code": "temp_unit_convert",
        "dp_id": 9,
        "type": "Enum",
        "values": "{\"range\":[\"c\",\"f\"]}"
      },
      {
        "code": "temp_current_f",
        "dp_id": 11,
        "type": "Integer",
        "values": "{\"unit\":\"℉\",\"min\":0,\"max\":500,\"scale\":0,\"step\":1}"
      },
      {
        "code": "countdown_left",
        "dp_id": 13,
        "type": "Integer",
        "values": "{\"unit\":\"min\",\"min\":0,\"max\":60,\"scale\":0,\"step\":1}"
      },
      {
        "code": "work_state",
        "dp_id": 14,
        "type": "Enum",
        "values": "{\"range\":[\"standby\",\"heating\"]}"
      }
    ]
  },
  "success": true,
  "t": 1766020881715,
  "tid": "dcb08b6bdbaf11f08abb3a48fff754fc"
}
1 Like

For anyone else having the issue here is a yaml config for the necessary configuration to control a SereneLife towel warmer. You can save it in the templates folder and select use template to configure. Should allow for power on/off, setting time on, start/stop, current temp, current status, and time remaining within entity.

- switch:
    friendly_name: Power
    entity_category: config
    restore_on_reconnect: false
    is_passive_entity: false
    device_class: switch
    id: '1'
    platform: switch
    icon: ''
- switch:
    friendly_name: Start
    entity_category: config
    restore_on_reconnect: false
    is_passive_entity: false
    device_class: switch
    id: '103'
    platform: switch
    icon: ''
- sensor:
    friendly_name: Time Remaining
    entity_category: diagnostic
    unit_of_measurement: min
    device_class: duration
    state_class: measurement
    id: '13'
    platform: sensor
    icon: ''
- sensor:
    friendly_name: Status
    entity_category: diagnostic
    device_class: enum
    state_class: measurement
    id: '14'
    platform: sensor
    icon: ''
- sensor:
    friendly_name: Current Temperature
    entity_category: diagnostic
    unit_of_measurement: F
    device_class: temperature
    state_class: measurement
    id: '11'
    platform: sensor
    icon: ''
- select:
    entity_category: config
    select_options:
      20min: 20min
      40min: 40min
      60min: 60min
    restore_on_reconnect: false
    is_passive_entity: false
    friendly_name: ''
    id: '12'
    platform: select
    icon: ''
1 Like

Thanks for the work!
I configure it but only show my power meter and not the 3 sensors of temp and humidity.
The power meter btw only show the switch trigger, not all the info about power consumtion, voltage, current etc…any chance to get them?