summaryrefslogtreecommitdiff
path: root/README.md
blob: 9f6aea394a5b0e25164ee5483e5b3881bab95a66 (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 [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 you need the Xlib 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 |
| buttom              | 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";
```