LocalTuya 2.0 — The Next Generation of Local Tuya Control
_{Maintained by BildaSystem.cz}

Why? • Features • Install • Roadmap • Docs

🇬🇧 English | 🇨🇿 Čeština

The original LocalTuya was a game-changer for Tuya device owners. But development stalled, bugs piled up, and Home Assistant kept evolving. We stepped in to keep LocalTuya alive.

LocalTuya 2.0 fixes all of this and more. We're committed to keeping local Tuya control alive and thriving.

💡 Philosophy: Your smart home should work locally, without cloud dependencies. That's why LocalTuya exists, and that's why we maintain it.

No Tuya developer account needed! Just scan a QR code:

• Open Smart Life app → Me → Settings → User Code
• Enter the code in LocalTuya 2.0
• Scan QR with app → Done!
• All your devices and local_keys are fetched automatically

Full support for the latest Tuya protocol:

• GCM encryption for secure communication
• 6699 packet prefix handling
• Proper heartbeat with retry logic
• Works with newest Tuya devices

Keep your entities organized in large installations:

• Set a prefix per device (e.g., "Living Room", "Bedroom #1")
• All entities get prefixed automatically
• Example: Living Room Temperature instead of just Temperature
• Perfect for multiple devices of the same type

• Scaling factor - multiply raw values (e.g., 0.1 for temperature)
• Device class - proper icons and units in HA
• Enum support (v7.8+) - translate raw values to friendly names
  • Raw: 0, 1, 2 → Display: Off, Heating, Cooling

Pre-configured templates for common devices:

• Auto-detection by product_id
• One-click setup - no manual DP configuration
• Community templates - growing library

Currently supported:

• 🌡️ Inkbird ITC-308-WIFI - Temperature controller (heating/cooling)
• 💡 Smart Mini Bulb RGB+CCT (Protocol 3.5)
• ⭐ Smart Star Projector
• 🌬️ Tesla Air Purifier Mini
• 💧 Tesla Dehumidifier XL
• 🔌 Tesla Power Strip PS300
• 🌬️ BlitzWolf Air Cleaner
• 🐾 Nedis Pet Feeder - Auto feeder with portions
• 🐾 Pet Feeder DU3L - Advanced pet feeder
• ⚡ KWS-302WF Energy Meter
• 🔌 Circuit Breaker 63A
• 🪟 Roleta M313EIRWT
• ...and more coming!

💡 Have a device? Open an issue with your device info and we'll add a template!

Change host, local_key, or protocol without reconfiguring entities:

Settings → Devices → LocalTuya 2.0 → Configure
→ Select device → Quick edit
→ Done in 10 seconds!

Fetch all local_keys with one click:

• No manual copy-paste from Tuya IoT
• Shows which keys changed
• Smart sync - only updates modified keys

Run alongside original LocalTuya:

• Different domain (localtuya_bildass)
• Test before migrating
• Zero conflicts

• EU - Central Europe
• EU West - Western Europe
• US - Western America
• US East - Eastern America
• CN - China
• IN - India
• SG - Singapore (new!)

1. Open HACS → Integrations
2. Click ⋮ → Custom repositories
3. Add: https://github.com/Bildass/localtuya
4. Category: Integration
5. Find LocalTuya 2.0 → Download
6. Restart Home Assistant

cd /config/custom_components
git clone https://github.com/Bildass/localtuya.git temp
mv temp/custom_components/localtuya_bildass .
rm -rf temp
# Restart Home Assistant

We're actively developing LocalTuya 2.0. Here's what's coming:

• Matter bridge - expose LocalTuya devices to Matter
• Device diagnostics - built-in network analyzer
• Firmware version detection - track device updates
• Scenes support - Tuya scene activation

📣 Have a feature request? Open an issue or start a discussion!

1. Install via HACS (see above)
2. Add Integration: Settings → Devices & Services → Add → LocalTuya 2.0
3. Configure Cloud API (optional but recommended):
   • Get credentials from Tuya IoT Platform
   • Region, Client ID, Client Secret, User ID
4. Add Devices: Cloud Sync auto-fills device info!

# configuration.yaml
logger:
  default: warning
  logs:
    custom_components.localtuya_bildass: debug
    custom_components.localtuya_bildass.pytuya: debug

Good news: You can run both versions simultaneously!

1. Install LocalTuya 2.0 via HACS
2. Export existing config (local_keys are precious!)
3. Add devices to LocalTuya 2.0
4. Test everything
5. Remove original when satisfied

Update references in: Automations, Scripts, Dashboards, Templates

📚 Full migration guide: See Migration Guide section below.

• v7.8.0 - Sensor enum device_class support, Entity naming prefix

• v7.7.0 - Inkbird ITC-308-WIFI temperature controller template

• v7.6.0 - Number entity scaling, device class, unit of measurement support

• v7.5.0 - Config flow refactoring - split into 6 modular files (mixins)

• v7.4.0 - 🔐 QR Code Authentication - no developer account needed!

• v7.3.20 - Fix template name display in options flow
• v7.3.19 - Add all Tuya regions (SG, EU West, US East) with friendly names
• v7.3.18 - Heartbeat optimization, optimistic UI updates
• v7.3.17 - Remove rate limiting (caused delays)
• v7.3.16 - Smart Mini Bulb template, product_id detection fix

• v7.0.0 - Complete pytuya rewrite, Protocol 3.5 support, Device Library

• v6.0.0 - Quick Edit, Entity List, Cloud Sync, Async API

We welcome contributions!

• 🐛 Report bugs - Open an issue
• 💡 Request features - Start a discussion
• 📚 Add device templates - Share your working configs
• 🌍 Translations - Help localize the integration
• 🔧 Code - PRs welcome!

git clone https://github.com/Bildass/localtuya.git
cd localtuya
# Create feature branch
git checkout -b feature/amazing-feature
# Make changes, commit, push
git push origin feature/amazing-feature
# Open PR

• 🌐 Website: bildassystem.cz
• 📧 Email: info@bildassystem.cz
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

Built upon the excellent work of:

• rospogrigio/localtuya - Original project
• jasonacox/tinytuya - Protocol implementation
• make-all/tuya-local - Inspiration for QR auth research

Community Contributors:

• @galentx - Inkbird ITC-308-WIFI template, enum support & entity prefix ideas
• Everyone who reports bugs, suggests features, and shares device configs!

LocalTuya 2.0
Keeping local Tuya control alive.

© 2024-2025 BildaSystem.cz
_{Fork of rospogrigio/localtuya • Licensed under GPL-3.0}

#!/usr/bin/env python3
"""Export LocalTuya device configurations for migration to LocalTuya 2.0"""

import json
from pathlib import Path

config_path = Path('/config/.storage/core.config_entries')
with open(config_path, 'r') as f:
    data = json.load(f)

devices = []
for entry in data['data']['entries']:
    if entry.get('domain', '').lower() == 'localtuya':
        device_data = entry.get('data', {})
        devices.append({
            'name': entry.get('title', 'Unknown'),
            'device_id': device_data.get('device_id'),
            'local_key': device_data.get('local_key'),
            'host': device_data.get('host'),
            'protocol_version': device_data.get('protocol_version', '3.3'),
            'entities': device_data.get('entities', [])
        })

output_path = Path('/config/localtuya_export.json')
with open(output_path, 'w') as f:
    json.dump(devices, f, indent=2)

print(f"✅ Exported {len(devices)} devices to {output_path}")

# configuration.yaml
sensor:
  - platform: template
    sensors:
      smart_plug_voltage:
        friendly_name: "Smart Plug Voltage"
        value_template: "{{ state_attr('switch.localtuya_bildass_plug', 'voltage') }}"
        unit_of_measurement: 'V'
        device_class: voltage

      smart_plug_current:
        friendly_name: "Smart Plug Current"
        value_template: "{{ state_attr('switch.localtuya_bildass_plug', 'current') }}"
        unit_of_measurement: 'mA'
        device_class: current

      smart_plug_power:
        friendly_name: "Smart Plug Power"
        value_template: "{{ state_attr('switch.localtuya_bildass_plug', 'current_consumption') }}"
        unit_of_measurement: 'W'
        device_class: power