summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorCraig Jennings <craigmartinjennings@gmail.com>2023-07-16 15:11:07 -0500
committerCraig Jennings <craigmartinjennings@gmail.com>2023-07-16 15:11:07 -0500
commit15b2ac2204a40de0693bf76f66bc471050e38e6a (patch)
tree6036b356b31dca92be068ac387892b1068c4055e /README.md
moving from githubHEADmain
Diffstat (limited to 'README.md')
-rw-r--r--README.md71
1 files changed, 71 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2b0bf08
--- /dev/null
+++ b/README.md
@@ -0,0 +1,71 @@
+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).
+
+
+NO FURTHER DEVELOPMENT
+----------------------
+
+This project is no longer under development. If you have another opinion feel free to fork it.
+
+
+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
+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";
+```