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. 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.

# Similar software

[Pass: the standard unix password manager](http://www.passwordstore.org/)

[caodonnell/passman.sh: a pwd.sh fork](https://github.com/caodonnell/passman.sh)

[anders/pwgen: generate passwords using OS X Security framework](https://github.com/anders/pwgen)
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
Add option to suppress password output. Update README to mention this feature and Alternative projects. 2015-08-05 02:48:09 +00:00			`Options can also be passed on the command line. Here are some examples:`
Update README instructions and zap args variable 2015-07-31 04:14:09 +00:00
Add option to suppress password output. Update README to mention this feature and Alternative projects. 2015-08-05 02:48:09 +00:00			`./pwd.sh w gmail 30` to create a password for 'gmail' with a length of 30 characters. Append `<space>q` to suppress password output.
Update README instructions and zap args variable 2015-07-31 04:14:09 +00:00
Add option to suppress password output. Update README to mention this feature and Alternative projects. 2015-08-05 02:48:09 +00:00			`./pwd.sh r user@github` to read the password for 'user@github'.
Support password length command line argument when generating and writing passwords 2015-07-31 04:35:35 +00:00
Add option to suppress password output. Update README to mention this feature and Alternative projects. 2015-08-05 02:48:09 +00:00			`./pwd.sh d dropbox` to delete the password for 'dropbox'.
Support password length command line argument when generating and writing passwords 2015-07-31 04:35:35 +00:00
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.
Add option to suppress password output. Update README to mention this feature and Alternative projects. 2015-08-05 02:48:09 +00:00
Mention new fork. Close #26. 2015-09-21 23:23:13 +00:00			`# Similar software`
Add option to suppress password output. Update README to mention this feature and Alternative projects. 2015-08-05 02:48:09 +00:00
			`[Pass: the standard unix password manager](http://www.passwordstore.org/)`

Mention new fork. Close #26. 2015-09-21 23:23:13 +00:00			`[caodonnell/passman.sh: a pwd.sh fork](https://github.com/caodonnell/passman.sh)`

			`[anders/pwgen: generate passwords using OS X Security framework](https://github.com/anders/pwgen)`
Fast fail if password file is missing. 2015-08-07 18:11:11 +00:00