pw icon indicating copy to clipboard operation
pw copied to clipboard

:closed_lock_with_key: a mnml password manager

pw

a mnml password manager

Dependencies

  • bash
  • gpg2 (will add gpg support later)
  • xclip for clipboard support

Usage

Requires PW_KEY to be set. Do so by appending this to your .bashrc / .zshrc:

export [email protected]

This is your GPG key's associated email ID.

Optionally, you may set PW_DIR to your desired path to change the default password store location, which is ~/.pw. To override the default password length of 25, set PW_LEN to a number of your choice.

pw - mnml password manager

usage: pw [options] [NAME]
All options except -i and -h require a NAME argument.

options:
  -i            Initializes password directory at $HOME/.pw or at $PW_DIR, if it exists.
  -a            Add a password.
  -g            Generate a password.
  -s            Print password to STDOUT.
  -l            List out all passwords.
  -c            Copy existing password to clipboard.
  -d            Delete password.  
  -h            Display this help message and exit.

Examples

$ PW_DIR=~/passwords pw -i
pw: password directory initialized at /home/icy/passwords

$ pw -a twitter
enter password: 
pw: /home/icy/.pw/twitter.gpg created

$ pw -c twitter
pw: copied twitter to clipboard

$ pw -s twitter
notmyrealpassword

$ pw -g github
pw: generated password for github
pw: /home/icy/.pw/github.gpg created

$ pw -l
fake
github
more
passwords
some
twitter

Notes

  • Uses pwgen -s to generate passwords.
  • Lacks directory support because I don't need it.
  • Why not pass(1)? 700 lines vs 100 lines.