trezor-gpg-pinentry-tk

A pinentry for GPG with Trezor


License
BSD-3-Clause
Install
pip install trezor-gpg-pinentry-tk==0.0.10

Documentation

Trezor-style PIN entry for GPG

This is an alternate PIN entry for use with trezor-agent or for people with number-only PINs. It displays a grid of unlabeled buttons and supports configurable keyboard mappings.

By default you can use any of these key grids to enter the PIN:

w e r      u i o      7 8 9
s d f      j k l      4 5 6
x c v      m , .      1 2 3

Press escape to cancel, backspace to clear everything you've entered, and enter to submit the PIN.

Installation

  1. Run pip install trezor-gpg-pinentry-tk
  2. Find where it's installed with by running which trezor-gpg-pinentry-tk
  3. Add this line to $GPGHOME/gpg-agent.conf: pinentry-program /path/to/trezor-gpg-pinentry-tk
  4. Run echo RELOADAGENT | gpg-connect-agent or restart your computer

Configuration

Set these environment variables on your gpg-agent daemon, by overriding /usr/lib/systemd/user/gpg-agent.service for example.

  • PINENTRY_TREZOR_LOG_PATH = /path/to/log/file. Enable logging and write logs to /path/to/log/file
  • PINENTRY_TREZOR_DONT_FLASH = 1. Don't show which keypad button was pressed when using the keyboard.
  • PINENTRY_TREZOR_KEYSET = 123456789. Use this letter grid for keyboard entry.
  • PINENTRY_TREZOR_DONT_EXPLAIN = 1. Don't explain or show the grid when entering via TTY.
  • PINENTRY_TREZOR_FORCE_MESSAGE = My prompt message:. Use this prompt message instead of the GPG provided prompt.