GPG-TUI.TOML(5)

📦 version 0.11.2, in arch rolling

🌸 GPG-TUI.TOML(5) 🌸

okay bestie, so this is the file formats manual page for gpg-tui.toml — yes, that's the config file for gpg-tui, and no, you don't have to be scared of it, i promise 🫶

✨ NAME ✨

gpg-tui.toml — the configuration file for gpg-tui, literally the glow-up settings page for your terminal gpg era 💅

🦋 SYNOPSIS 🦋

So gpg-tui.toml is a configuration file for gpg-tui, and it has to live in one of these exact spots, no cap:

$HOME/.config/gpg-tui.toml, $HOME/.config/gpg-tui/gpg-tui.toml,
$HOME/.config/gpg-tui/config

You can also point at it manually with the --config option, or with the $GPG_TUI_CONFIG environment variable. iconic, right? 🌈

and if the file isn't there at the right location, or you just didn't provide one at all — no stress — gpg-tui just uses its default configuration settings. she's got you 💖

🎀 DESCRIPTION 🎀

The TOML file that configures gpg-tui has a section of general settings, followed by the gpg section, which lets you configure the GnuPG options. two sections, one vibe check, we love to see it ⭐

👑 FORMAT 👑

`[general]`

the section for general settings, your main character settings if you will 💜

splash — show the splash screen on startup (default: false) ✨
tick_rate — set the tick rate of the terminal (default: 250)
color — set the accent color of the terminal (default: gray) 🎨
style — set the style of the terminal (default: colored) (possible values: plain, colored) 💅
file_explorer — set the utility for file selection (default: xplr) 🦋
detail_level — set the detail level for the keys (default: minimum) (possible values: minimum, standard, full) 👀
log_file — set the file to save the logs 📝
key_bindings — list of custom key bindings (your own little keyboard choreography, iykyk) ⌨️

`[gpg]`

the section for GnuPG settings — this is where the gpg girlies live 🔐

armor — enable ASCII armored output (default: false) 🛡️
homedir — set the GnuPG home directory 🏠
outdir — set the output directory 📁
outfile — set the template for the output file name 🏷️
default_key — set the default key to sign with 🔑

🌈 EXAMPLE 🌈

here's the whole complete gpg-tui.toml default configuration example — screenshot this, it's giving reference material 📸

[general]
  splash = false
  tick_rate = 250
  color = "gray"
  style = "colored"
  file_explorer = "xplr"
  detail_level = "minimum"
  key_bindings = [
    { keys = [ "?", "h", "f1" ], command = ":help" },
    { keys = [ "C-d", "C-c", "q" ], command = ":quit" },
  ]

[gpg]
  armor = false
  homedir = "~/.gnupg"
  outdir = "~/.gnupg/out"
  outfile = "{type}_{query}.{ext}"
  default_key = ""

like, look at her. flawless. no notes. 🌸

💀 BUGS 💀

found a bug? don't suffer in silence bestie 😭 report bugs at <https://github.com/orhun/gpg-tui/issues> or contact the author via email. they wanna know, fr fr 🙈

🫶 AUTHOR 🫶

Orhun Parmaksız <orhunparmaksiz@gmail.com> — the icon, the moment, the legend 👑

⭐ 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. go read it, it's worth it 💖

🧚 SEE ALSO 🧚

gpg-tui(1) — the main character herself 🌟

k bye ily, go configure something beautiful 💅✨

gpg-tui 0.11.2 · April 2026 · GPG-TUI.TOML(5) — that's the version and the date, mwah, see you in the config file bestie 🍓💜

📦 where this page comes from

arch rolling: gpg-tui 0.11.2-1 · MIT
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms