readme.md (1907B)
1 # pinentry-dmenu 2 3 This is a simple shell script that integrates [suckless](https://suckless.org/)' [dmenu](https://tools.suckless.org/dmenu/) with [GnuPG](https://gnupg.org/) as an alternative pinentry method. 4 5 ## Installation 6 7 ### Manual 8 9 To install this, do a `git clone https://github.com/drincoxyz/pinentry-dmenu`, configure `config.mk` for your system and run `sudo make install`. Similarly, to uninstall run `sudo make uninstall`. 10 11 ### Arch User Repository (AUR) 12 13 There's also an [AUR package](https://aur.archlinux.org/packages/pinentry-dmenu-inco/) available, which is recommended for Arch users. To install it, do a `git clone https://aur.archlinux.org/pinentry-dmenu-inco.git` and run `makepkg -si`, or use an AUR wrapper like [yay](https://aur.archlinux.org/packages/yay/) and simply run `yay -S pinentry-dmenu-inco` as a non-root user. 14 15 Note that the [pinentry-dmenu](https://aur.archlinux.org/packages/pinentry-dmenu) AUR package is **not** related to this project. That's another alternative that does more or less the same thing, but it builds its own dmenu binary with the [password](https://tools.suckless.org/dmenu/patches/password/) patch applied automatically. This project is much simpler, as it uses the first dmenu binary it finds on the system. 16 17 ## Usage 18 19 Firstly, you will need a dmenu build with the [password](https://tools.suckless.org/dmenu/patches/password/) patch applied, otherwise dmenu will not show up when used as the pinentry program. 20 21 Then, to use dmenu as the pinentry program for GnuPG, configure `~/.gnupg/gpg-agent.conf` to use the full path of the `pinentry-dmenu` script: 22 23 ``` 24 pinentry-program /usr/bin/pinentry-dmenu 25 ``` 26 27 The full path will depend on the `PREFIX` used in `config.mk`. The above example would apply to users who installed the AUR package, but by installing it with `make` with the default `PREFIX` installs it to `/usr/local/bin/pinentry-dmenu`.