Purse/README.md

# 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, e.g.,

`./pwd.sh w gmail 30` to generate and write a password called 'gmail' with a length of 30 characters, or

`./pwd.sh r github` to read the password called 'github', or

`./pwd.sh d dropbox` to delete the password called '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.
Initial commit 2015-07-02 00:52:01 +00:00			`# pwd.sh`
Add README 2015-07-02 02:11:49 +00:00
Smaller screencast 2015-07-03 04:52:34 +00:00			`Script to manage passwords in an encrypted file using gpg.`
Add README 2015-07-02 02:11:49 +00:00
Updated screencast gif to match new output 2015-07-03 21:22:25 +00:00			`![screencast gif](https://i.imgur.com/sQoF3VN.gif)`
Add README 2015-07-02 02:11:49 +00:00
			`# Installation`

			`git clone https://github.com/drduh/pwd.sh && cd pwd.sh`
Smaller screencast 2015-07-03 04:52:34 +00:00
Support password length command line argument when generating and writing passwords 2015-07-31 04:35:35 +00:00			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).
Smaller screencast 2015-07-03 04:52:34 +00:00
Add README 2015-07-02 02:11:49 +00:00			`# Use`

Update README instructions and zap args variable 2015-07-31 04:14:09 +00:00			Run the script interactively with `./pwd.sh`

Update screencast gif, readme docs and license title. 2015-07-03 03:19:35 +00:00			Type `w` to write a password.
Add README 2015-07-02 02:11:49 +00:00
Update README instructions and zap args variable 2015-07-31 04:14:09 +00:00			Type `r` to read a password(s).
Add README 2015-07-02 02:11:49 +00:00
Update screencast gif, readme docs and license title. 2015-07-03 03:19:35 +00:00			Type `d` to delete a password.
Add delete option 2015-07-02 02:31:38 +00:00
Support password length command line argument when generating and writing passwords 2015-07-31 04:35:35 +00:00			`Options can also be passed on the command line, e.g.,`
Update README instructions and zap args variable 2015-07-31 04:14:09 +00:00
Support password length command line argument when generating and writing passwords 2015-07-31 04:35:35 +00:00			`./pwd.sh w gmail 30` to generate and write a password called 'gmail' with a length of 30 characters, or
Update README instructions and zap args variable 2015-07-31 04:14:09 +00:00
Support password length command line argument when generating and writing passwords 2015-07-31 04:35:35 +00:00			`./pwd.sh r github` to read the password called 'github', or

			`./pwd.sh d dropbox` to delete the password called 'dropbox'.

Indent by 2 spaces throughout. Add example for copying password to clipboard on OS X. 2015-07-31 04:53:28 +00:00			`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.

Support password length command line argument when generating and writing passwords 2015-07-31 04:35:35 +00:00			The script and `pwd.sh.safe` encrypted file can be safely shared between machines over public channels (Google Drive, Dropbox, etc).
Initial check-in 2015-07-02 02:03:55 +00:00
Version 2. Use symmetric crypto instead of keys. Don't write passwords in plaintext to disk. Choose passwords by character length. Add recommended gpg configuration. 2015-07-03 02:56:16 +00:00			A sample `gpg.conf` configuration file is provided for your consideration.