summaryrefslogtreecommitdiff
path: root/README.md
blob: 8cdbcf64b194bb716f749022f774fe5d5da8492b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
pinentry-dmenu
==============

pinentry-dmenu is a pinentry program with the charm of [dmenu](https://tools.suckless.org/dmenu).

This program is a fork from [dmenu-pinentry](https://github.com/ritze/pinentry-dmenu) which is a fork from [spine](https://gitgud.io/zavok/spine.git) which is also a fork from [dmenu](https://tools.suckless.org/dmenu).


Requirements
------------
In order to build dmenu-pinentry you need the Xlib, and libconfig header files.


Installation
------------
Edit config.mk to match your local setup (dmenu is installed into the /usr/local namespace by default).

Afterwards enter the following command to build and install dmenu
(if necessary as root):

	make clean install


Config
------
To use pinentry-dmenu add in `~/.gnupg/gpg-agent.conf`:

	pinentry-program <absolut path to pinentry-dmenu>

The config is located in `~/.gnupg/pinentry-dmenu.conf`.

Parameter           | Default           | Description
:------------------ |:----------------- |:-----------
asterisk            | *                 | Defines the symbol which is showed for each typed character
bottom              | false             | pinentry-dmenu appears at the bottom of the screen
min_password_length | 32                | The minimal space of the password field. This value has affect to the description field after the password field
monitor             | -1                | pinentry-dmenu is displayed on the monitor number supplied. Monitor numbers are starting from 0
prompt              | ""                | Defines the prompt to be displayed to the left of the input field
font                | monospace:size=10 | Defines the font or font set used
prompt_bg           | #bbbbbb           | Defines the prompt background color
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


Example
-------
```
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";
```