pass

simple password manager
git clone git://git.2f30.org/pass
Log | Files | Refs | README | LICENSE

README.md (1506B)


      1 # pass
      2 
      3 A stripped down version of the standard unix password manager "pass" in C.
      4 
      5 # Dependencies
      6 
      7 gpg2
      8 libgpgme
      9 
     10 # Installation
     11 
     12 Edit config.mk to match your setup (pass is installed into 
     13 /usr/local/ namespace by default).
     14 
     15 Post-configuration:
     16 
     17 $ make
     18 $ doas make install
     19 
     20 # Documentation:
     21 
     22 * With pass, each password lives inside of a gpg encrypted file whose filename is
     23   the title of the website or resource that requires the password.
     24 * These encrypted files may be dealt with like any other file & manipulated 
     25   using standard command line file management utilities.
     26 * Passwords live inside the respective files in ~/.password-store.
     27 * pass provides some commands for adding, removing and retrieving passwords.
     28 * Editing passwords is possible by overwriting them.
     29 
     30 # Commands
     31 
     32 init:	
     33 	initialize new password storage and use a gpg-uid for encryption.
     34 	
     35 insert: 
     36 	insert a new password into the password store.  
     37 
     38 rm: 	
     39 	remove password from the password store.
     40 
     41 show:
     42 	"show" is just a place-holder. Invoking pass with the filename will
     43 	decrypt it and print the password to stdout.
     44 
     45 help:
     46 	Show usage message.
     47 
     48 ver:
     49 	Show version information
     50 
     51 # Credits
     52 
     53 Jason at zx2c4 dot com <https://www.passwordstore.org/>
     54 
     55 # Extras
     56 
     57 pkg_install tree pwgen
     58 
     59 You may use tree to view the structure of files and directories in
     60 ~/.password-store.
     61 You can pipeline the output of pwgen to pass; creating complex passwords.
     62 	pwgen -1 | pass insert Email/userid@domain.com
     63 Note: pass will read input until newline.