Flash, authorize, and debug
your devices
A free, modern firmware tool for TuyaOpen-supported chips.
tyutool pairs a clean cross-platform desktop app with a scriptable command-line tool โ flash on your desk, automate in CI, and get the same dependable result either way.
Everything you need to bring a board up
From the first flash on your desk to authorizing a full production batch.
Firmware flash & read
Write .bin firmware or dump flash back to a file. Per-chip baud defaults, custom address ranges, live progress, and a clean cancel that always releases the port.
Device authorization
Write and verify a Tuya UUID + AuthKey over UART, or read the current authorization state. An auth-only mode handles devices that just need a license, no flashing.
Serial debug monitor
A built-in serial terminal with real ANSI color rendering, hex and ASCII views, timestamps, and one-click capture โ so you can watch logs without leaving the tool.
Batch flash & auth
Flash and authorize many boards in parallel from a single window, each port with its own progress and status. Drive authorization from a spreadsheet for production lines.
Desktop app & command line
A friendly desktop app for everyday work, and a scriptable command line for automation and CI. Both flash, authorize, and debug the same way โ pick whichever fits the moment.
Cross-platform & self-updating
Runs on Windows, macOS, and Linux. The recommended installers keep themselves up to date, and one-click log export makes filing a useful bug report easy.
A friendly GUI, or a scriptable CLI
Pick the interface that fits the moment โ both do exactly the same job.
Desktop GUI
Pick a chip, choose your firmware and port, and hit flash. Tabs for flashing, authorization, serial debug, and batch tools โ with your settings remembered between sessions.
- Point-and-click flashing
- Live progress & phase view
- Remembers your last setup
Command-line
Nothing to install โ one self-contained download. Great for automation, CI pipelines, and headless machines, with clean plain-text output when piped to a log.
- Scriptable & CI-friendly
- Shell completions included
- Self-update built in
# Flash firmware (port auto-detected)
$ tyutool write -d bk7231n -f firmware.bin
# Dump the current flash to a file
$ tyutool read -d t5ai -p /dev/ttyUSB0 -f dump.bin
# Write Tuya authorization
$ tyutool authorize -p /dev/ttyUSB0 \
--uuid <UUID> --authkey <AUTHKEY>
# List serial ports as JSON
$ tyutool list-ports --jsonMulti-chip support
Flashing support is built in for the chips below, with more added over time.
Bring up a whole batch at once
The batch toolbox turns one operator and a USB hub into a small flashing line.
- Flash many ports in parallel, each with independent progress and status.
- Authorize from a spreadsheet โ one UUID / AuthKey row per device.
- Flash-then-authorize, or authorize-only for licensed-but-pre-flashed boards.
- Per-slot cancel and retry, plus running success / failure tallies.
Get tyutool
Grab the desktop app for your platform, or the standalone CLI. Builds are unsigned โ the guide covers the one-time "open anyway" step.
Prefer the command line?
Standalone CLI builds are available for Linux, macOS, and Windows on the same releases page โ no runtime to install.
Ready to flash your first board?
Download tyutool, or read the guide first โ both take only a minute.