passmenu

Fork of zx2c4's passmenu with OTP support added.
git clone https://codeberg.org/tilt/passmenu.git
Log | Files | Refs | README | LICENSE

README.md (1800B)


      1 passmenu
      2 ========
      3 
      4 This is my fork of [zx2c4's passmenu][].
      5 
      6 passmenu is a [dmenu][]-based interface to [pass][], the standard Unix password
      7 manager. Its design allows you to quickly copy a password to the clipboard
      8 without having to open up a terminal window if you don't already have one open. 
      9 
     10 **The only difference in this fork is that passwords stored in `pass tfa/`-folder
     11 will be copied  to clipboard using the `pass otp` extension instead of plain
     12 `pass`. Additionally, the font is set to mononoki.**
     13 
     14 # How to use
     15 
     16 ## Install prerequisite packages
     17 
     18 `gpg` - for generating and managing PGP keys.
     19 
     20 `pass` - the password store.
     21 
     22 `pass-extension-otp` - extension for otp.
     23 
     24 `dmenu` - for spawning passmenu.
     25 
     26 ## Optional
     27 
     28 `nerd-fonts-mononoki` - the font this script uses
     29 
     30 `zbarimg` - to copy otp urls from qr codes.
     31 
     32 ## Set up pass
     33 
     34 Normal passwords can go in any folder or directly in pass root folder. 
     35 When you store a otp url, put these in a pass folder named `tfa`, for example, 
     36 if you downloaded a qr code image with the name canvas.png:
     37 
     38 `zbarimg canvas.png`
     39 
     40 Copy url from `otpauth://...` (i.e. don't include `QR-Code:`)
     41 
     42 Then run:
     43 
     44 `pass otp add tfa/name-of-website-here`
     45 
     46 And paste the otpauth URI you copied previously when prompted.
     47 
     48 ## Put `passmenu` script in a folder that is in your users path and set a
     49 shortcut for it to launch.
     50 
     51 Now when copying from any other folder than the tfa folder pass will use the
     52 normal `pass -c somde-folder-name/name-of-website` syntax and for the passwords
     53 in tfa folder it will use `pass otp -c tfa/name-of-website`.
     54 
     55 ---
     56 
     57 [zx2c4's passmenu]: https://git.zx2c4.com/password-store/tree/contrib/dmenu
     58 [dmenu]: http://tools.suckless.org/dmenu/
     59 [pass]: http://www.zx2c4.com/projects/password-store/
     60 [pass-otp]: https://github.com/tadfisher/pass-otp