249 lines
4.6 KiB
Markdown
249 lines
4.6 KiB
Markdown
% PINENTRY-DMENU(1) Version\-VERSION | pinentry-dmenu Manual
|
|
|
|
# NAME
|
|
|
|
pinentry-dmenu - a pinentry program based on dmenu
|
|
|
|
# SYNOPSIS
|
|
|
|
Set the **pinentry-program** in *~/.gnupg/gpg-agent.conf* to **pinentry-dmenu** to use the program as the regular dialog for **gpg-agent**.
|
|
|
|
The configuration is placed in *~/.gnupg/pinentry-dmenu.conf*. You can change the path to the config file with the environment variable *GNUPGHOME*.
|
|
|
|
# DESCRIPTION
|
|
|
|
**pinentry-dmenu** is a dmenu- and pinentry-based passphrase dialog called from the **gpg-agent**(1) daemon. It is not intended to be invoked directly.
|
|
|
|
# OPTIONS
|
|
|
|
**monitor** = *-1*
|
|
: pinentry-dmenu is displayed on the monitor number supplied. Monitor numbers are starting from 0. Value -1 for focused monitor.
|
|
|
|
**center_width** = *1024*
|
|
: Defines the width for the 'center' menu. Value -1 for full width.
|
|
|
|
**embedded** = *false*
|
|
: Embed into window.
|
|
|
|
**line_height** = *25*
|
|
: Defines menu line of at least 'line_height' pixels tall.
|
|
|
|
**border_width** = *1*
|
|
: Defines the border width for the menu.
|
|
|
|
**min_password_length** = *32*
|
|
: The minimal space of the password field. This value has affect to the description field after the password field.
|
|
|
|
**prompt_fg_alpha** = *255*
|
|
: Defines the prompt foreground alpha value. Values between *0* (transparent) and *255* (opaque) are supported.
|
|
|
|
**prompt_bg_alpha** = *255*
|
|
: Defines the prompt background alpha value.
|
|
|
|
**normal_fg_alpha** = *255*
|
|
: Defines the normal foreground alpha value.
|
|
|
|
**normal_bg_alpha** = *230*
|
|
: Defines the normal background alpha value.
|
|
|
|
**select_fg_alpha** = *255*
|
|
: Defines the selected foreground alpha value.
|
|
|
|
**select_bg_alpha** = *255*
|
|
: Defines the selected background alpha value.
|
|
|
|
**desc_fg_alpha** = *255*
|
|
: Defines the description foreground alpha value.
|
|
|
|
**desc_bg_alpha** = *255*
|
|
: Defines the description background alpha value.
|
|
|
|
**position** = *"center"*
|
|
: Defines the position of the menu. *bottom*, *center* and *top* are supported.
|
|
|
|
**font** = *"DejaVuSansMono Nerd Font:pixelsize=16"*
|
|
: Defines the font or font set used.
|
|
|
|
**prompt** = *""*
|
|
: Defines the prompt to be displayed to the left of the input field.
|
|
|
|
**asterisk** = *"\*"*
|
|
: Defines the symbol which is showed for each typed character.
|
|
|
|
**prompt_fg** = *"#cccccc"*
|
|
: Defines the prompt foreground color. *#RGB*, *#RRGGBB* and X color names are supported.
|
|
|
|
**prompt_bg** = *"#4185d7"*
|
|
: Defines the prompt background color.
|
|
|
|
**normal_fg** = *"#cccccc"*
|
|
: Defines the normal foreground color.
|
|
|
|
**normal_bg** = *"#000000"*
|
|
: Defines the normal background color.
|
|
|
|
**select_fg** = *"#ffffff"*
|
|
: Defines the selected foreground color.
|
|
|
|
**select_bg** = *"#4185d7"*
|
|
: Defines the selected background color.
|
|
|
|
**desc_fg** = *"#cccccc"*
|
|
: Defines the description foreground color.
|
|
|
|
**desc_bg** = *"#4185d7"*
|
|
: Defines the description background color.
|
|
|
|
# USAGE
|
|
|
|
**pinentry-dmenu** is completely controlled by the keyboard.
|
|
|
|
**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
|
|
|
|
| monitor = -1;
|
|
| center_width = 1024;
|
|
| embedded = false;
|
|
| line_height = 25;
|
|
| border_width = 1;
|
|
| min_password_length = 32;
|
|
| prompt_fg_alpha = 255;
|
|
| prompt_bg_alpha = 255;
|
|
| normal_fg_alpha = 255;
|
|
| normal_bg_alpha = 230;
|
|
| select_fg_alpha = 255;
|
|
| select_bg_alpha = 255;
|
|
| desc_fg_alpha = 255;
|
|
| desc_bg_alpha = 255;
|
|
| position = "center";
|
|
| font = "DejaVuSansMono Nerd Font:pixelsize=16";
|
|
| prompt = "";
|
|
| asterisk = "\*";
|
|
| prompt_fg = "#cccccc";
|
|
| prompt_bg = "#4185d7";
|
|
| normal_fg = "#cccccc";
|
|
| normal_bg = "#000000";
|
|
| select_fg = "#ffffff";
|
|
| select_bg = "#4185d7";
|
|
| desc_fg = "#cccccc";
|
|
| desc_bg = "#4185d7";
|
|
|
|
# BUGS
|
|
|
|
See GitHub Issues: *https://github.com/mrdotx/pinentry-dmenu/issues*
|
|
|
|
# AUTHORS
|
|
|
|
| **pinentry-dmenu** is a fork of **dmenu** <*https://tools.suckless.org/dmenu*> and uses the api of **pinentry**, a GnuPG tool.
|
|
| **pinentry-dmenu** was written by mrdotx <*klassiker@gmx.de*>
|
|
|
|
# SEE ALSO
|
|
|
|
**dmenu**(1), **dwm**(1), **gpg-agent**(1)
|
|
|
|
# LICENSE
|
|
|
|
See the *LICENSE.md* file for the terms of redistribution.
|