aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md37
1 files changed, 36 insertions, 1 deletions
diff --git a/README.md b/README.md
index fec1ffc..babaa08 100644
--- a/README.md
+++ b/README.md
@@ -71,13 +71,29 @@ in a convenient way using [rofi](https://github.com/DaveDavenport/rofi).
* The field names for `user`, `url` and `autotype` are configurable
* Bookmarks mode (open stored URLs in browser, default: Alt+x)
* Share common used passwords between several entries (with different URLs, usernames etc)
+* Change backend with environment variable `ROFI_PASS_BACKEND`, valid
+ backends are `xdotool` or `wtype`. For example use `rofi-pass` with
+ [wtype](https://github.com/atx/wtype):
+ ```
+ ROFI_PASS_BACKEND=wtype rofi-pass
+ ```
+
+ or
+
+ ```
+ ROFI_PASS_BACKEND=wtype ROFI_PASS_CLIPBOARD_BACKEND=wl-clipboard rofi-pass
+ ```
+
+ Alternative change the backend in the config file using
+ `backend=wtype` or `clibpoard_backend=wl-clipboard`.
## Requirements
* [pass](http://www.passwordstore.org/)
* sed
* [rofi](https://github.com/DaveDavenport/rofi)
-* xdotool
+* xdotool or wtype
+* xclip or wl-clipboard
* gawk
* bash 4.x
* find
@@ -157,6 +173,23 @@ To get this, you need to set `default_user` to `:filename` in your configuration
Make sure to run `setxkbmap <language> <variant>` at the start of your Xorg
session.
+### rofi pass hangs after selecting password
+
+To access passwords your GPG agent needs to have unlocked your secret key
+you're using to encrypt your passwords with. If the secret key hasn't been
+unlocked yet it will prompt for the secret key password using `pinentry`. If
+`pinentry` is configured to read from a `tty` then `rofi-pass` will hang
+indefinitely. To fix this you need to [configure gpg][gpg_pinentry_config] to
+use a gui version of `pinentry`. E.g.
+```
+$ cat ~/.gnupg/gpg-agent.conf
+pinentry-program /usr/bin/pinentry-qt
+```
+You may have to kill the GPG agent if it's still in a bad state:
+```
+killall -9 gpg-agent
+```
+
## Alternative
jreinert has written the roughly compatible tool
@@ -164,3 +197,5 @@ jreinert has written the roughly compatible tool
definately saner code.
Also he provided a nice little script called `passed` to change your
fieldnames. [link](https://github.com/jreinert/passed)
+
+[gpg_pinentry_config][https://github.com/bfrg/gpg-guide/blob/master/gpg-agent.conf#L15]