GPG-TUI(1)

πŸ“¦ version 0.11.2, in alpine 3.24, arch rolling

πŸ’… GPG-TUI(1) β€” the gpg-tui manual, but make it make sense

okay so bestie, welcome to the gpg-tui manual page (that's the General Commands Manual section of the docs, iykyk) β€” the whole thing is about managing your GnuPG keys with ease, and honestly? it ate. let's get into it ✨

🌸 NAME 🌸

gpg-tui β€” manage your GnuPG keys with ease 🫢

⭐ SYNOPSIS ⭐

gpg-tui [OPTIONS]

that's it. that's the whole vibe. options go in, keys get managed. πŸ’…

πŸ¦‹ DESCRIPTION πŸ¦‹

so gpg-tui is literally a Terminal User Interface for GnuPG. a whole TUI. in your terminal. for your keys. iconic behavior honestly.

its whole goal is to make key management operations β€” the stuff like listing / exporting / signing β€” way less painful, by handing you an actual interface, plus a command-line fallback for when you need to do the more complex operations. it is not trying to be a full-fledged interface for every single feature that gpg provides, no cap β€” it's just trying to bring a more interactive approach</> to key management. and it slays at that. ✨

πŸŽ€ OPTIONS πŸŽ€

okay this is the part where we go through every single flag, no skipping, no summarising, because we respect the docs in this house πŸ’–

  • -a, --armor β€” enables ASCII armored output. armor up bestie πŸ›‘οΈ
  • --splash β€” shows the splash screen on startup. a little treat for you 🌈
  • --config <path> β€” sets the configuration file. [env: GPG_TUI_CONFIG=]
  • --homedir <dir> β€” sets the GnuPG home directory. [env: GNUPGHOME=]
  • -o, --outdir <dir> β€” sets the output directory. [env: OUTDIR=]
  • --outfile <path> β€” sets the template for the output file name. [env: OUTFILE=]
  • -d, --default-key <key> β€” sets the default key to sign with. [env: DEFAULT_KEY=]
  • -t, --tick-rate <ms> β€” sets the tick rate of the terminal. [env: TICK_RATE=] [default: 250]
  • -c, --color <color> β€” sets the accent color of the terminal. [env: COLOR=] [default: gray]
  • -s, --style <style> β€” sets the style of the terminal. [env: STYLE=] [default: colored] [possible values: plain, colored]
  • -f, --file-explorer <app> β€” sets the utility for file selection. [env: FILE_EXPLORER=] [default: xplr]
  • --detail-level <level> β€” sets the detail level for the keys. [env: DETAIL_LEVEL=] [default: minimum] [possible values: minimum, standard, full]
  • --log-file <path> β€” sets the file to save the logs. [env: LOG_FILE=]
  • --select <option> β€” enables the selection mode. [env: SELECT=] [possible values: key_id, key_fpr, user_id, row1, row2]
  • -h, --help β€” prints help information. your little map πŸ—ΊοΈ
  • -V, --version β€” prints version information. proof you're on the right build ✨
ngl the env var brackets are literally part of the spec, so they stay exactly as-is. don't @ me.

πŸ”₯ KEY BINDINGS πŸ”₯

the moment you've been waiting for: the keybinds. learn these and you're genuinely main character energy in the terminal πŸ‘‘

πŸ’œ USER INTERFACE

  • ? β€” show help
  • o, space, enter β€” show options
  • hjkl, arrows, pgkeys β€” navigate
  • n β€” switch to normal mode
  • v β€” switch to visual mode
  • c β€” switch to copy mode
  • p, C-v β€” paste from clipboard
  • a β€” toggle armored output
  • 1, 2, 3 β€” set detail level
  • t, tab β€” toggle detail (all/selected)
  • ` β€” toggle table margin
  • m β€” toggle table size
  • C-s β€” toggle style
  • / β€” search
  • : β€” run command
  • r, f5 β€” refresh application
  • q, C-c/d, escape β€” quit application

🧚 KEY MANAGEMENT

  • x β€” export key
  • s β€” sign key
  • e β€” edit key
  • i β€” import key(s)
  • f β€” receive key
  • u β€” send key
  • g β€” generate key
  • d, backspace β€” delete key
  • C-r β€” refresh keys

πŸ’€ BUGS πŸ’€

found a bug? first of all, mood. 😭 report it at <https://github.com/orhun/gpg-tui/issues> or contact the author via email. they literally want to know, fr fr.

πŸ‘‘ AUTHOR πŸ‘‘

Orhun ParmaksΔ±z <orhunparmaksiz@gmail.com> β€” the icon behind all of this 🫢

🌟 ABOUT 🌟

gpg-tui is maintained by Orhun ParmaksΔ±z, and released under the MIT license.

see the project homepage at <https://github.com/orhun/gpg-tui> for full documentation. it's giving ✨ completeness ✨

πŸ“ SEE ALSO πŸ“

gpg-tui.toml(5) β€” go read it, bestie πŸ’–

and that's the whole page!! this was gpg-tui 0.11.2, dated April 2026 β€” you're officially caught up, bestie. go manage those keys, slay, and remember: the vibe check is the manual πŸ’…πŸŽ€πŸ¦‹
πŸ“¦ where this page comes from