Python library and commandline client for communicating with TREZOR Hardware Wallet
See https://trezor.io for more information
Python-trezor requires Python 3.3 or higher, and libusb 1.0. The easiest
way to install it is with
pip. The rest of this guide assumes you have
pip; if not, you can refer to this
Trezor T only
On a typical Linux / Mac / BSD system, you already have all you need.
pip3 install --upgrade setuptools pip3 install trezor
Trezor One support
In addition to the above, you need to install development headers for HIDAPI.
On a Debian or Ubuntu based system, you can install these:
sudo apt-get install python3-dev python3-pip cython3 libusb-1.0-0-dev libudev-dev
When installing the trezor library, you need to specify that you want
pip3 install --upgrade setuptools pip3 install trezor[hidapi]
Ethereum requires additional python packages. Instead of
pip3 install trezor, specify
pip3 install trezor[ethereum].
You can combine it with the above, to get both HIDAPI and Ethereum support:
pip3 install trezor[ethereum,hidapi]
On FreeBSD you can install the packages:
pkg install security/py-trezor
or build via ports:
cd /usr/ports/security/py-trezor make install clean
Command line client (trezorctl)
trezorctl python script can perform various tasks such as
changing setting in the Trezor, signing transactions, retrieving account
info and addresses. See the docs/ sub folder for detailed
examples and options.
You can use this python library to interact with a Bitcoin Trezor and use its capabilities in your application. See examples here in the tools/ sub folder.
When you are asked for PIN, you have to enter scrambled PIN. Follow the numbers shown on TREZOR display and enter the their positions using the numeric keyboard mapping:
Example: your PIN is 1234 and TREZOR is displaying the following:
You have to enter: 3795
Python-trezor pulls coins info and protobuf messages from
trezor-common repository. If
you are developing new features for Trezor, you will want to start
there. Once your changes are accepted to
trezor-common, you can make a
PR against this repository. Don't forget to update the submodule with:
git submodule update --init --remote
Then, rebuild the protobuf messages and get
coins.json by running:
python3 setup.py prebuild
To get support for BTC-like coins, these steps are enough and no further changes to the library are necessary.