Skip to main content

TinyTuya Wizard

tinytuya_wizard is an interactive wizard for discovering registered devices on Tuya Cloud.


🔧 Features

  • QR code login via SmartLife / Tuya app
  • Automatic cloud credential handling
  • Fetch Tuya device information from the cloud
  • Optional local network scan to match IPs

📦 Installation

pip install tinytuya_wizard

▶️ Usage

Standard execution

python3 -m tinytuya_wizard

⚙️ Command-line Options

Option Description
max_time Maximum time to find devices during polling (default: 18)
-force / -f Force scan device IP addresses
-nocolor Disable colored terminal output
-yes / -y Automatically answer yes to prompts
-no-poll / -no Skip local IP polling (overrides -yes)
-device-file FILE Path for storing the device list JSON
-credentials-file FILE Path for storing cloud credentials JSON

💾 Output

Upon completion, the wizard writes the following:

  • Cloud credentials JSON
  • Device informations JSON

❗ Notes

  • This project does not modify tinytuya — it is an interactive wrapper focused on simplicity and usability.
  • Currently using temporary Home Assistant client credentials. Intended to be replaced when 3rd Party credentials become available.
  • Warning tinytuya.json will be replaced with new QR-based credentials information.

Release files for tinytuya-wizard 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tinytuya-wizard 0.1.2
File Size Uploaded
tinytuya_wizard-0.1.2.tar.gz 5.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tinytuya-wizard 0.1.2
File Interpreter ABI Platform
tinytuya_wizard-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 12.0 kB

Release files / tinytuya_wizard-0.1.2.tar.gz

Download URL tinytuya_wizard-0.1.2.tar.gz
Size 5.5 kB
Tags Source
SHA-256 checksum
How to use checksums
64ab4b25b91316a1c71534810bcf4f6eec4f12ae0af5d0a091d24fd304dce3c6
BLAKE2b-256 checksum
How to use checksums
f5077c731803b17df4faaa81013de3b7f6fd4dbce2221f1d94df4d137886479d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / tinytuya_wizard-0.1.2-py3-none-any.whl

Download URL tinytuya_wizard-0.1.2-py3-none-any.whl
Size 6.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eba16fca0c3de63a5c1c5d946657ce0a633ccffb293a3509b2c9a0d8b1dccff5
BLAKE2b-256 checksum
How to use checksums
4e5e918f020f3460b6f746fa8f6be6e5d1409a2c41f4c5e640fd851cd3dc2eeb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page