pinentry-dmenu/pinentry-dmenu.1
2021-07-28 13:43:42 +02:00

279 lines
4.7 KiB
Groff

.TH PINENTRY-DMENU 1 "DATE" pinentry-dmenu\-VERSION "pinentry-dmenu Manual"
.SH NAME
pinentry-dmenu - a pinentry program based on dmenu
.SH DESCRIPTION
.B pinentry-dmenu
is a dmenu- and pinentry-based passphrase dialog called from the
.BR gpg-agent (1)
daemon. It is not intended to be invoked directly.
.SH SYNOPSIS
Set the
.B pinentry-program
in
.IR ~/.gnupg/gpg-agent.conf
to
.B pinentry-dmenu
to use the program as the regular dialog for
.BR gpg-agent .
.PP
The configuration is placed in
.IR ~/.gnupg/pinentry-dmenu.conf .
You can change the path to the config file with the environment variable
.IR GNUPGHOME .
.SH OPTIONS
.TP
.BI "monitor =" " -1"
pinentry-dmenu is displayed on the monitor number supplied. Monitor numbers are starting from 0.
.TP
.BI "center =" " false"
pinentry-dmenu appears in the center of the screen.
.TP
.BI "center_width =" " 1024"
Defines the width for the 'center' menu.
.TP
.BI "bottom =" " false"
pinentry-dmenu appears at the bottom of the screen.
.TP
.BI "embedded =" " false"
Embed into window.
.TP
.BI "line_height =" " 22"
Defines menu line of at least 'line_height' pixels tall.
.TP
.BI "border_width =" " 2"
Defines the border width for the menu.
.TP
.BI "min_password_length =" " 32"
The minimal space of the password field. This value has affect to the description field after the password field.
.TP
.BI "prompt_fg_alpha =" " 255"
Defines the prompt foreground alpha value.
Values between
.IR 0
(transparent) and
.IR 255
(opaque) are supported.
.TP
.BI "prompt_bg_alpha =" " 255"
Defines the prompt background alpha value.
.TP
.BI "normal_fg_alpha =" " 255"
Defines the normal foreground alpha value.
.TP
.BI "normal_bg_alpha =" " 230"
Defines the normal background alpha value.
.TP
.BI "select_fg_alpha =" " 255"
Defines the selected foreground alpha value.
.TP
.BI "select_bg_alpha =" " 255"
Defines the selected background alpha value.
.TP
.BI "desc_fg_alpha =" " 255"
Defines the description foreground alpha value.
.TP
.BI "desc_bg_alpha =" " 255"
Defines the description background alpha value.
.TP
.BI "font =" " DejaVuSansMono Nerd Font:pixelsize=16:antialias=true:autohint=true"
Defines the font or font set used.
.TP
.BI "prompt =" " """"
Defines the prompt to be displayed to the left of the input field.
.TP
.BI "asterisk =" " *"
Defines the symbol which is showed for each typed character.
.TP
.BI "prompt_fg =" " #cccccc"
Defines the prompt foreground color.
.IR #RGB ,
.I #RRGGBB
and X color names are supported.
.TP
.BI "prompt_bg =" " #4185d7"
Defines the prompt background color.
.TP
.BI "normal_fg =" " #cccccc"
Defines the normal foreground color.
.TP
.BI "normal_bg =" " #000000"
Defines the normal background color.
.TP
.BI "select_fg =" " #ffffff"
Defines the selected foreground color.
.TP
.BI "select_bg =" " #4185d7"
Defines the selected background color.
.TP
.BI "desc_fg =" " #cccccc"
Defines the description foreground color.
.TP
.BI "desc_bg =" " #4185d7"
Defines the description background color.
.SH USAGE
pinentry-dmenu is completely controlled by the keyboard.
.TP
.B Return
Confirm input
.TP
.B Ctrl-Return
Confirm input
.TP
.B Shift\-Return
Confirm input
.TP
.B Escape
Cancel input
.TP
.B C\-c
Escape
.SS Confirm Mode
.TP
.B Down
Right
.TP
.B End
Right
.TP
.B Home
Left
.TP
.B Next
Right
.TP
.B Prior
Left
.TP
.B Up
Left
.TP
.B g
Cancel input
.TP
.B G
Cancel input
.TP
.B h
Left
.TP
.B j
Left
.TP
.B k
Right
.TP
.B l
Right
.TP
.B n
Confirm with no
.TP
.B N
Confirm with no
.TP
.B y
Confirm with yes
.TP
.B Y
Confirm with yes
.SS Pin Mode
.TP
.B End
Move cursor to the line end
.TP
.B Home
Move cursor to the line begin
.TP
.B C\-a
Home
.TP
.B C\-b
Left
.TP
.B C\-d
Delete
.TP
.B C\-e
End
.TP
.B C\-f
Right
.TP
.B C\-g
Escape
.TP
.B C\-h
Backspace
.TP
.B C\-k
Delete line right
.TP
.B C\-u
Delete line left
.TP
.B C\-v
Paste from primary X selection
.SH EXAMPLES
.sp
.if n \{
.RS 4
.\}
.nf
monitor = -1;
center = false;
center_width = 1024;
bottom = false;
embedded = false;
line_height = 22;
border_width = 2;
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;
font = "DejaVuSansMono Nerd Font:pixelsize=16:antialias=true:autohint=true";
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";
.SH AUTHORS
.B pinentry-dmenu
is a fork of
.B dmenu
<https://tools.suckless.org/dmenu>
and uses the api of
.B pinentry
, a GnuPG tool.
.PD 0
.P
.PD
.B pinentry-dmenu
was written by mrdotx
.RI < klassiker@gmx.de >
.SH REPORTING BUGS
Report pinentry-dmenu bugs to <BUGREPORT>
.SH SEE ALSO
.BR dmenu (1),
.BR dwm (1),
.BR gpg-agent (1)