1
0
mirror of https://github.com/octoleo/Purse.git synced 2024-06-03 15:00:51 +00:00
Purse/README.md
2015-08-07 14:11:11 -04:00

45 lines
1.4 KiB
Markdown

# pwd.sh
Script to manage passwords in an encrypted file using gpg.
![screencast gif](https://i.imgur.com/sQoF3VN.gif)
# Installation
git clone https://github.com/drduh/pwd.sh && cd pwd.sh
Requires `gpg`. Install with `brew install gpg` or `sudo apt-get install gnupg` or build and install it from [source](https://www.gnupg.org/download/index.html).
# Use
Run the script interactively with `./pwd.sh`
Type `w` to write a password.
Type `r` to read a password(s).
Type `d` to delete a password.
Options can also be passed on the command line. Here are some examples:
`./pwd.sh w gmail 30` to create a password for 'gmail' with a length of 30 characters. Append `<space>q` to suppress password output.
`./pwd.sh r user@github` to read the password for 'user@github'.
`./pwd.sh d dropbox` to delete the password for 'dropbox'.
Combine with other programs by piping output, e.g.,
`./pwd.sh r github | grep github | cut -f1 -d ' ' | pbcopy` to copy a password to clipboard on OS X.
The script and `pwd.sh.safe` encrypted file can be safely shared between machines over public channels (Google Drive, Dropbox, etc).
A sample `gpg.conf` configuration file is provided for your consideration.
# Recommended software
[Pass: the standard unix password manager](http://www.passwordstore.org/)
[sf-pwgen: generates passwords using OS X Security framework](https://github.com/anders/pwgen)