Command Line Control - v1.17.5 Feature

[jasonacox]

I have often thought that it would be handy to have a command line tool to turn on/off Tuya devices. I don't know why I never added this to TinyTuya. As ov v1.17.5, we now have command line extensions to do just that.

Here are some examples.

Setup

# Setup - Inital setup wizard to create the devcies.json file to make it easier to use named devices
tinytuya wizard

List Devices

# List Devices - Table 
tinytuya list

# Devices in JSON
tinytuya list --json

Device State

# Full status
tinytuya get --name "Dining Room"

# Just one DPS
tinytuya get --name "Dining Room" --dps 1

Control Devices

# Turn it on
tinytuya on --name "Dining Room"

# Turn it off
tinytuya off --name "Dining Room"

# Set the value
tinytuya set --name "Dining Room" --dps 9 --value 1

AI Friendly - Robot Ready

Fun fact: In case you are wondering, you can now tell AI Agents (e.g. OpenClaw) about TinyTuya and have it run wizard and these commands to control your home. With the simple CLI it makes it easy for it to figure out.

$ openclaw tui
                                                  

>  I want to use the tinytuya python library to control devices around my house. If you pip install 
>  tinytuya it should create a tinytuya command. That command has a setup wizard `tinytuya wizard`    
>  that will ask for some things like Key, Secret, Region and a Device ID to use. Use this tinytuya.json: {       
>      "apiKey": "xyaabc12345",                                                            
>      "apiSecret": "10234923492349234923",                                             
>      "apiRegion": "us",                                                                           
>      "apiDeviceID": "1abc134567890101938487"                                                        
>  }  

 

All done! Here's what happened:                                                                  
                                                                                                  
 ────────────────────────────────────────────────────────────────────────────────                 
                                                                                                  
 TinyTuya is set up and working. 🏠                                                               
                                                                                                  
 Files saved to your workspace:                                                                   
 - tinytuya.json — API config                                                                     
 - devices.json — All 49 registered devices with IDs, keys, and local IPs                         
 - snapshot.json — Current status of each device                                                  
 - tuya-raw.json — Full raw API response                                                          
                                                                                                  
 29 devices found on your local network (10.0.1.x). Here are the highlights:                      
                                                                                                  
 ┌─────────────────────────┬────────────┬────────┐                                                
 │ Device                  │ IP         │ Status │                                                
 ├─────────────────────────┼────────────┼────────┤                                                
 │ Chandelier              │ 10.0.1.1   │ 🟢 On  │                                                
 ├─────────────────────────┼────────────┼────────┤                                                
 │ Smart Bulb - Front Room │ 10.0.1.2   │ 🟢 On  │                                                
 ├─────────────────────────┼────────────┼────────┤                                                
 │ SmartBulb               │ 10.0.1.3   │ 🟢 On  │                                                
 ├─────────────────────────┼────────────┼────────┤                                                
 │ Kitchen Light           │ 10.0.1.4   │ ⚫ Off │                                                
 ├─────────────────────────┼────────────┼────────┤                                                
 │ Master Bedroom          │ 10.0.1.5   │ ⚫ Off │                                                
 ├─────────────────────────┼────────────┼────────┤                                                
 │ Front Porch             │ 10.0.1.6   │ ⚫ Off │                                                
 ├─────────────────────────┼────────────┼────────┤                                                
 │ Dining Room             │ 10.0.1.7   │ ⚫ Off │                                                
 ├─────────────────────────┼────────────┼────────┤                                               
 │ Zigbee Gateway          │ 10.0.1.8   │ —      │                                                
 └─────────────────────────┴────────────┴────────┘                                                
              
 > Nice job! You can now turn on the Kitchen Light for me by tinytuya on --name "Kitchen Light" 
                                                                                                                                                                                          

 Kitchen Light is on! 💡                                                                          
                                                                                                  
 Got a clean "1": true back — DPS 1 flipped to on. That tinytuya on/off --name syntax is handy,   
 I'll use that going forward. What else do you want to control?