xptsp/tuya-convert repository overview

⁠TUYA-CONVERT

A Chinese company named Tuya offers a free-to-brand turnkey smart home solution to anyone. Using their offer is dead-simple, since everything can be done by clicking through the Tuya web page⁠, from choosing your pre-designed products or pre-programmed wifi-modules (mostly ESP8266) to building your own app. In the end, this has resulted in as they claim over 11 000 devices 'made' by over 10 000 vendors using Tuyas firmware and cloud services.

Aside from that, they claim their cloud solution has 'military grade security'. Michael Steigerwald, founder of the German IT security startup VTRUST, was able to disprove this claim and presented his results in the "Smart home - Smart hack" talk at 35C3 in Leipzig: https://media.ccc.de/v/35c3-9723-smart_home_-_smart_hack⁠

In the following days, VTRUST and the German tech magazine c't decided to work together. Since reflashing devices using the ESP8266/85 is widespread among DIY smart home enthusiasts, we wanted to provide an easy way for everyone to free their devices from the cloud without the need for a soldering iron.

Please make sure to visit VTRUST (https://www.vtrust.de/⁠), since the hack is their work.

⁠USING DOCKER

⁠Requirements:

• Linux computer with a wifi adapter
• Secondary wifi device (e.g. smartphone)
• docker is installed
• docker-compose is installed

⁠The "docker-compose.yaml" file:

• Create docker-compose.yaml as follows:

version: '3'
services:
  tuya:
    container_name: tuya
    image: xptsp/tuya-convert:latest
    privileged: true
    network_mode: "host"
    environment:
      - WLAN=wlan0
      - AP=vtrust-flash
      - GATEWAY=10.42.42.1
    volumes:
      - ./data/backups:/usr/bin/tuya-convert/backups

• you may adjust this docker-compose.yaml, if necessary:
  • environment-variables may be different, for example network-adapter may be different from wlan0
  • adjust the volume folder, where you want your backups stored

⁠Run the image:

• go into the folder you copied docker-compose.yaml
• docker-compose up -d
• docker-compose exec tuya start
• tuya-convert now starts within docker

⁠Stop the image:

• docker-compose exec tuya stop
• docker-compose down

⁠Source GitHub repository:

This container was built using the Dockerfile found at https://github.com/ct-Open-Source/tuya-convert/⁠, commit 61ba060b8567eacd02813db431967cbe9fd23401⁠ dated January 26th, 2021. For more information, please visit the repository itself.