1
0
mirror of https://github.com/trezor/trezor-firmware.git synced 2024-12-28 00:58:09 +00:00
trezor-firmware/docs/python/show-text.md

138 lines
3.7 KiB
Markdown
Raw Normal View History

# Displaying text screens on Trezor T
## Requirements
For this feature, you will need a debug-enabled firmware for Trezor T. Usually that
will be the emulator.
You will also need `trezorctl` 0.12 or later. Best bet is to run the version from github
master.
## Trezor T text capabilities
The Trezor T screen has a _header_, with an icon and text. Below it is _body_, which
can fit up to 5 lines of text.
Text can be in one of several colors, and in one of three styles: NORMAL, BOLD, MONO.
It is possible to have multiple styles on the same line, but different styles must be
separated by a space.
I.e., this works fine:
> This word is **bold** and this is `monospaced`.
This will not work:
> Em**bold**ened middle, mono`space`d middle.
A line that is too long to fit on screen will automatically break, using a hyphen (`-`)
character. This is usually undesirable. Instead, a manual line-break should be inserted
in the appropriate place.
## Command line syntax
The most basic way to put words on screen is this:
```sh
trezorctl debug show-text "My hovercraft is full of eels, call the porter, there is a frog in my bidet."
```
The above command will show:
![Screenshot01](show-text-01.png)
Notice the "quotes" around the text. The whole body text must be enquoted.
To use quotes inside the text, prefix them with backslashes `\`:
```sh
trezorctl debug show-text "My \"hovercraft\" is full of eels."
```
![Screenshot02](show-text-02.png)
### Line breaks
Let's insert some line breaks. Do that by placing `@@BR` in the appropriate place
in the text:
```sh
trezorctl debug show-text "My hovercraft is full of @@BR eels, call the porter, @@BR there is a frog in my @@BR bidet."
```
![Screenshot03](show-text-03.png)
Better!
### Text styles
Now let's add some style. Use `@@BOLD` to start printing in bold. Use `@@NORMAL`
to go back to normal text. `@@MONO` works similarly.
```sh
trezorctl debug show-text "My hovercraft is @@BOLD full of @@BR eels. @@NORMAL Call the porter, @@BR there is a @@MONO frog @@NORMAL in my @@BR bidet."
```
![Screenshot04](show-text-04.png)
### Line spacing
Adding another `@@BR` after a `@@BR` will leave one line empty -- just like pressing
\<Enter\> twice.
If you don't want a full empty line, you can make a half-break with `@@BR_HALF`.
```sh
trezorctl debug show-text "Line one. @@BR @@BR Line two. @@BR @@BR_HALF Line three."
```
![Screenshot05](show-text-05.png)
### Text colors
To switch to one of the [available colors](../../core/src/trezor/ui/style.py#L14-L47),
use the color name prefixed with `%%`: e.g., `%%RED`, `%%LIGHT_BLUE`...
To switch back to the default color, you can use `%%FG`:
```sh
trezorctl debug show-text "My %%RED hovercraft is @@BOLD full %%GREEN of @@BR eels. @@NORMAL Call %%ORANGE the %%FG porter."
```
![Screenshot06](show-text-06.png)
### Headers
The default header says "Showing text" with an orange gear icon. It is possible to
change all of that.
To change the text, use `-h` option:
```sh
trezorctl debug show-text -h "Hello world" "My hovercraft is full."
```
To change the icon, you can pick [an icon name from here](../../core/src/trezor/ui/style.py#L50-L70) and specify it with the `-i` option:
```sh
trezorctl debug show-text -i RECEIVE "My hovercraft is full."
```
The icons are defined as shapes, and you can specify a custom color [from the list](../../core/src/trezor/ui/style.py#L14-L47) with the `-c` option:
```sh
trezorctl debug show-text -c RED "My hovercraft is full."
```
### Putting it all together
Here is how to reproduce the confirmation screen after the wallet is created:
```sh
trezorctl debug show-text -h "Success" -i CONFIRM -c GREEN "@@BOLD New wallet created @@BR successfully! @@BR @@BR_HALF @@NORMAL You should back up your @@BR new wallet right now."
```
![Screenshot07](show-text-07.png)