PINENTRY-DMENU(1)

🌸 PINENTRY-DMENU 🌸

okay so welcome to the pinentry-dmenu manual page bestie, this is the whole thing, we're doing it 💅

---

✨ NAME ✨

pinentry-dmenu — a pinentry program with the charm of dmenu 🎀

---

💖 DESCRIPTION 💖

so pinentry-dmenu is this passphrase dialog that's built on dmenu and pinentry, and it gets called by the gpg-agent(1) daemon. that's it, that's the vibe. it is not intended to be invoked directly — like, do not come for it personally, it has a job and it's employed elsewhere 🙈

---

🦋 SYNOPSIS 🦋

okay so the way you actually turn this on: set the pinentry-program in ~/.gnupg/gpg-agent.conf to pinentry-dmenu and then it becomes the regular dialog for gpg-agent. slay.

and the configuration lives in ~/.gnupg/pinentry-dmenu.conf. lowkey important: you can change the path to the config file with the environment variable GNUPGHOME ✨

---

👑 OPTIONS 👑

every single one, no skips, we're thorough in this house 💅

• asterisk = * — defines the symbol that gets showed for each typed character. ur secret little star ⭐
• bottom = false — pinentry-dmenu appears at the bottom of the screen. floor energy 🫶
• min_password_length = 32 — the minimal space of the password field. heads up: this value has affect to the description field after the password field — so it's not just the password field catching strays 😭
• monitor = -1 — pinentry-dmenu is displayed on the monitor number supplied. and monitor numbers are starting from 0, don't forget 🔥
• prompt = "" — defines the prompt to be displayed to the left of the input field. left side main character energy 💜
• font = monospace:size=10 — defines the font or font set used. the fit check 🎀
• prompt_bg = #bbbbbb — defines the prompt background color. and listen: #RGB, #RRGGBB and X color names are supported 🌈
• prompt_fg = #222222 — defines the prompt foreground color.
• normal_bg = #bbbbbb — defines the normal background color.
• normal_fg = #222222 — defines the normal foreground color.
• select_bg = #eeeeee — defines the selected background color.
• select_fg = #005577 — defines the selected foreground color.
• desc_bg = #bbbbbb — defines the description background color.
• desc_fg = #222222 — defines the description foreground color.
• embedded = false — embed into window. cozy 🧚

---

⭐ USAGE ⭐

pinentry-dmenu is completely controlled by the keyboard. no mouse, no vibes-based clicking, keyboard only bestie.

• Return — confirm input
• Ctrl+Return — confirm input
• Shift+Return — confirm input
• Escape — cancel input
• C-c — escape

💀 Confirm Mode 💀

• Down — right
• End — right
• Home — left
• Next — right
• Prior — left
• Up — left
• g — cancel input
• G — cancel input
• h — left
• j — left
• k — right
• l — right
• n — confirm with no
• N — confirm with no
• y — confirm with yes
• Y — confirm with yes

🍓 Pin Mode 🍓

• End — move cursor to the line end
• Home — move cursor to the line begin
• C-a — home
• C-b — left
• C-d — delete
• C-e — end
• C-f — right
• C-g — escape
• C-h — backspace
• C-k — delete line right
• C-u — delete line left
• C-v — paste from primary X selection

---

🎀 EXAMPLES 🎀

here's a whole config, copy-paste core fr fr, exactly as written:

    asterisk= "# ";
    prompt = "$";
    font = "Noto Sans UI:size=13";
    prompt_fg = "#eeeeee";
    prompt_bg = "#d9904a";
    normal_fg = "#ffffff";
    normal_bg = "#000000";
    select_fg = "#eeeeee";
    select_bg = "#d9904a";
    desc_fg = "#eeeeee";
    desc_bg = "#d9904a";

---

💜 AUTHORS 💜

so pinentry-dmenu is a fork of dmenu at https://tools.suckless.org/dmenu and it uses the api of pinentry, a GnuPG tool. and pinentry-dmenu itself was written by Moritz Lüdecke <ritze@skweez.net>. king behavior 👑

---

🫶 REPORTING BUGS 🫶

found a bug? report pinentry-dmenu bugs to https://github.com/ritze/pinentry-dmenu — they wanna hear it, no gatekeeping 🙈

---

🌈 SEE ALSO 🌈

dmenu(1), dwm(1), gpg-agent(1)

---

and that's the whole page bestie, you ate that 💅 this was pinentry-dmenu-0.1, from October 2026 — mwah, go secure ur passphrases, ily 🦋✨