trezorctl

List connected Trezor devices

$ trezorctl list

$ trezorctl get-features

$ trezorctl btc get-address -n "m/84'/0'/0'/0/0"

$ trezorctl btc sign-message -n "m/84'/0'/0'/0/0" "[message]"

$ trezorctl device wipe

$ trezorctl firmware-update

$ trezorctl device set-label "[My Trezor]"

$ trezorctl device change-pin

trezorctl [options] command [subcommand] [arguments]

trezorctl is the command-line interface for Trezor hardware wallets, providing advanced control over device configuration, cryptocurrency operations, and security settings. It is part of the trezorlib Python package and communicates with Trezor One, Trezor Model T, and Trezor Safe devices.
The tool enables signing transactions, deriving addresses, managing device settings, updating firmware, and performing recovery operations without using the graphical Trezor Suite application. It supports multiple cryptocurrencies including Bitcoin, Ethereum, and various altcoins.
All sensitive operations require physical confirmation on the device, maintaining security even when using command-line tools. The interface is designed for advanced users who need scriptable access to hardware wallet functions.

list

List all connected Trezor devices.

Retrieve device information including model, firmware version, and settings.

Get a Bitcoin address at the specified BIP32 derivation path.

Sign a message using the key at the specified path.

Sign a Bitcoin transaction interactively.

Wipe the device and reset to factory settings.

Initialize a new device with seed generation.

Recover a device using an existing seed phrase.

Change or set the device PIN.

Set a custom label for the device.

Unlock the bootloader for advanced operations.

Update device firmware to the latest version.

Set safety check level. Strict enforces full security; prompt allows overrides.

Enable verbose output.

Show help for a command.

Requires Python 3.9 or higher and libusb. On Linux, udev rules must be configured for device detection. Some operations like device wipe are irreversible; ensure seed phrase backup before proceeding. The device must be connected and unlocked for most commands.

trezorctl was developed by SatoshiLabs as part of the Python tools for Trezor, the first hardware cryptocurrency wallet released in 2014. The command-line interface evolved alongside the device firmware, adding support for new cryptocurrencies and security features. The tool is maintained in the official trezor-firmware repository.

gpg(1), openssl(1)