Skip to main content

GUI - tyutool Graphical Tool

Overview​

tyutool is the flashing and device-authorization tool for TuyaOpen. It writes firmware to a device over a serial port and writes the device authorization credentials (UUID and AuthKey). tyutool ships in two versions: GUI (graphical interface) and CLI (command line). This page covers the GUI.

danger

The authorization function of tyutool applies only to the TuyaOpen project, not the TuyaOS project. A TuyaOpen authorization code is valid only for TuyaOpen, and a TuyaOS authorization code is valid only for TuyaOS. The two are not interchangeable.

tyutool runs on Windows, Linux, and macOS. Choose the version that matches your operating system.

tyutool is currently available in two versions, V2 and V3, with the following key differences:

  • V3 (latest): Completely rewritten with a Rust (Tauri 2) + Vue 3 architecture for better cross-platform compatibility. Recommended for Mac users. Audio debugging and batch flashing are not yet supported.
  • V2: Original architecture with full feature support, including audio debugging and batch flashing.
note

V3 does not yet support audio debugging and batch flashing from V2. If you need these features, please download V2.

PlatformSource (Recommended)
Githubgithub-source
Giteegitee-source

Release download links by version:

VersionGithub
V3 (Recommended for Mac)v3.0.8
V2v2.3.2

V3 recommended downloads by platform (x.x.x in filenames is the version number — check Releases for the latest version)

PlatformRecommended FileAuto-updateNotes
Windows x86_64★ tyutool-gui_windows_x86_64_nsis_x.x.x.exe✅NSIS installer
Windows x86_64tyutool-gui_windows_x86_64_portable_x.x.x.zip❌Portable, no install needed
macOS Universal★ tyutool-gui_macos_universal_dmg_x.x.x.dmg✅DMG installer
macOS Universaltyutool-gui_macos_universal_portable_x.x.x.tar.gz❌Extract and run
Linux x86_64★ tyutool-gui_linux_x86_64_appimage_x.x.x.AppImage✅Run after chmod +x, cross-distro
Linux aarch64★ tyutool-gui_linux_aarch64_appimage_x.x.x.AppImage✅Run after chmod +x, cross-distro
Linux x86_64tyutool-gui_linux_x86_64_deb_x.x.x.deb / _rpm_x.x.x.rpm❌Debian / Fedora·RHEL
Linux aarch64tyutool-gui_linux_aarch64_deb_x.x.x.deb❌Debian-based
Linux x86_64 / aarch64tyutool-gui_linux_*_portable_x.x.x.tar.gz❌Extract and run
note

The tos.py flash command ultimately calls the tyutool_cli tool. The tyutool_gui tool is a graphical interface built on top of tyutool_cli.

The following will introduce the usage instructions for flashing and authorization with the tyutool_gui tool.

Firmware Flashing​

After opening tyutool_gui, the interface is displayed as follows:

tyutool flashing view
  • ① Select the chip.
  • ② Click Browse and select the firmware file to flash (the bin file containing _QIO).
  • ③ Select the device port for flashing. For Tuya official development boards and some partner development boards, hovering over a serial port indicates whether it is a flashing/authorization port or a log port.
  • ④ Click Start flash to begin flashing the firmware.
tip

The default baud rate for flashing is 921600. If you find the flashing speed too slow, you can increase the baud rate appropriately. However, increasing the baud rate may cause the firmware flashing to fail.

Device Authorization Information Writing​

To use the Tuya IoT platform, you must first authorize the device. Use the tyutool_gui tool to write the authorization credentials as follows.

After opening tyutool_gui, click the Authorize tab. The interface is as follows:

tyutool authorization view
  • ① Click the Authorize tab.
  • ② Select the authorization serial port.
  • ③ Select the authorization baud rate.
  • ④ Enter the UUID and AuthKey.
  • ⑤ Click Start Authorization.
tip

The authorization UART and the flashing UART are the same. Keep the UART default configuration (baud rate: 115200, data bits: 8, stop bits: 1, parity: none).

info

The TuyaOpen UUID and AuthKey can be obtained from the Tuya IoT Platform or purchased from Tuya's official Taobao store.

Frequently Asked Questions​

Flashing always fails at the write stage​

For the CH34x series, install or update the driver:

On Mac, after installing the driver, allow it to load in Security Settings.

When the driver installs successfully, the CH34x device is recognized with a name starting with cu.wchusb. If it is not, the driver did not install correctly.

On MacOS 13, operate in "Privacy & Security".

MacOS 13
MacOS 13