A bridge between https://github.com/jasonacox/tinytuya and Home Assistant via MQTT


A bridge between jasonacox/tinytuya and Home Assistant via MQTT.

Leveraging Home Assistant's autodiscovery means there is no configuration required on the HA side. Once this is setup, your devices will just appear, and will be controllable from HA.

 Home             MQTT        tinytuya2mqtt 
                                Tuya       Tuya  
                                Fan        Light 


Ensure tinytuya2mqtt.ini and snapshot.json are in the current directory. Ensure your broker IP has been set in docker-compose.yml:

docker compose up

Or, without docker:



docker compose build

Or, without docker:

python3 -m venv venv && source venv/bin/activate
pip install -e .


Two things are required:

  1. snapshot.json
  2. tinytuya2mqtt.ini


Follow the setup process for tinytuya using the wizard which is part of that project. This will create a file snapshot.json which is used by tinytuya2mqtt.

python -m tinytuya wizard


Create a tinytuya2mqtt.ini config file, mapping your device pins to the named capabilities. Also ensure to include your MQTT broker hostname. For example:

hostname =

[device bf7bf4939779bbd9afllck]
fan_state = 1
fan_speed = 3
fan_speed_steps = 1,2,3,4,5,6
light_state = 15
light_brightness = 16
light_brightness_steps = 25,125,275,425,575,725,900,1000
light_temp = 17

[device bf66790922f582082fao6p]
fan_state = 1
fan_speed = 3
fan_speed_steps = 1,2,3,4,5,6


Device types and capabilities supported by tinytuya2mqtt:

Type Subtype Name Example
Fan Fan fan_state 1
Fan Fan fan_speed 3
Fan Fan fan_speed_steps 1,2,3,4,5,6
Fan Light light_state 15
Fan Light light_brightness 16
Fan Light light_brightness_steps 25,125,275,425,575,725,900,1000
Fan Light light_temp 17

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.