summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--README91
1 files changed, 91 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..df900b5
--- /dev/null
+++ b/README
@@ -0,0 +1,91 @@
+======================
+Simple Password Store
+by Jason Donenfeld
+ Jason@zx2c4.com
+======================
+
+This is a very simple password store that encrypts passwords using gpg and
+places the encrypted password in a directory. It can generate new passwords
+and keep track of old ones.
+
+
+Usage:
+ pass --init gpg-id
+ Initialize new password storage and use gpg-id for encryption.
+ pass [--ls]
+ List passwords.
+ pass pass-name
+ Show existing password.
+ pass --insert [--multiline] pass-name
+ Insert new optionally multiline password.
+ pass --generate [--no-symbols] pass-name pass-length
+ Generate a new password of pass-length with optionally no symbols.
+ pass --remove pass-name
+ Remove existing password.
+ pass --help
+ Show help text.
+
+Examples:
+
+ - Initialize password store:
+
+ zx2c4@laptop ~ $ pass --init Jason@zx2c4.com
+ mkdir: created directory ‘/home/zx2c4/.password-store’
+ Password store initialized for Jason@zx2c4.com.
+
+ - List existing passwords in store:
+
+ zx2c4@laptop ~ $ pass
+ ├── Business
+ │ ├── some-silly-business-site.com
+ │ └── another-business-site.net
+ ├── Email
+ │ ├── donenfeld.com
+ │   └── zx2c4.com
+ └── France
+ ├── bank
+ ├── freebox
+ └── mobilephone
+
+ Alternatively, "pass --ls".
+
+ - Show existing password:
+
+ zx2c4@laptop ~ $ pass Email/zx2c4.com
+ sup3rh4x3rizmynam3
+
+ - Add password to store:
+
+ zx2c4@laptop ~ $ pass --insert Business/cheese-whiz-factory
+ Enter password for Business/cheese-whiz-factory: omg so much cheese what am i gonna do
+
+ Or, multiline passwords:
+
+ zx2c4@laptop ~ $ pass --insert --multiline Business/cheese-whiz-factory
+ Enter contents of Business/cheese-whiz-factory and press Ctrl+D when finished:
+
+ Hey this is my
+ awesome
+ multi
+ line
+ passworrrrrrrrd.
+ ^D
+
+ - Generate new password:
+
+ zx2c4@laptop ~ $ pass --generate Email/jasondonenfeld.com 15
+ The generated password to Email/jasondonenfeld.com is:
+ $(-QF&Q=IN2nFBx
+
+ Or, with no symbols:
+
+ zx2c4@laptop ~ $ pass --generate --no-symbols Email/jasondonenfeld.com 12
+ The generated password to Email/jasondonenfeld.com is:
+ YqFsMkBeO6di
+
+ - Remove password from store:
+
+ zx2c4@laptop ~ $ pass --remove Business/cheese-whiz-factory
+ rm: remove regular file ‘/home/zx2c4/.password-store/Business/cheese-whiz-factory.gpg’? y
+ removed ‘/home/zx2c4/.password-store/Business/cheese-whiz-factory.gpg’
+