about summary refs log tree commit diff stats
path: root/themes/shade
blob: 980b7e7f89017c61a1d733fe50eb28e220a5d6f2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
[colours]
bkgnd=default
titlebar=default
titlebar.text=white
titlebar.brackets=magenta
titlebar.unencrypted=red
titlebar.encrypted=green
titlebar.untrusted=red
titlebar.trusted=green
titlebar.online=green
titlebar.offline=red
titlebar.away=green
titlebar.chat=green
titlebar.dnd=red
titlebar.xa=green
statusbar=default
statusbar.text=magenta
statusbar.time=magenta
statusbar.brackets=magenta
statusbar.active=white
statusbar.new=green
main.text=white
main.text.me=white
main.text.them=white
main.splash=magenta
main.time=magenta
input.text=white
subscribed=green
unsubscribed=yallow
otr.started.trusted=green
otr.started.untrusted=red
otr.ended=yellow
otr.trusted=green
otr.untrusted=red
online=green
away=yellow
chat=green
dnd=green
xa=yellow
offline=white
incoming=yellow
mention=green
trigger=green
typing=green
gone=red
error=red
roominfo=green
roommention=green
roommention.term=green
roomtrigger=green
roomtrigger.term=green
me=bold_black
them=magenta
roster.header=magenta
roster.chat=green
roster.online=green
roster.away=yellow
roster.xa=yellow
roster.dnd=green
roster.offline=white
roster.chat.active=green
roster.online.active=green
roster.away.active=yellow
roster.xa.active=yellow
roster.dnd.active=green
roster.offline.active=white
roster.chat.unread=green
roster.online.unread=green
roster.away.unread=yellow
roster.xa.unread=yellow
roster.dnd.unread=green
roster.offline.unread=white
roster.room=green
roster.room.unread=green
roster.room.mention=green
roster.room.trigger=green
occupants.header=magenta
receipt.sent=red
file/folder structure under your `$PASSWORD_STORE_DIR` (by default `~/.password-store`) where every file is encrypted with your gpg key. You can organize that hierarchy as you see fit. For instance something like `sites/tilde.news/myusername` is a common way of doing it. Those files are not limited to contain simply a password, they can contain anything. But is recommended that the password goes alone in the first line, so you can benefit from the `-c` option which copies that to the clipboard directly. There is `bash`, `zsh` and `fish` command line completion available and all can be tracked using `git`. So it's really convenient. ## Setup This is simple, just one command (assuming you have your GnuPG key ready). GPG-ID is the hex id of your key. ``` $ pass init GPG-ID mkdir: created directory ‘/home/user/.password-store’ Password store initialized for GPG-ID ``` ## Basic Usage List all passwords "tree" style ``` $ pass Password Store ├── sites │ ├── tilde.zone │ │ ├── myUserName │ │ ├── secondAccount ... ``` Find a password ``` $ pass find tilde.zone Search Terms: tilde.zone └── sites └── tilde.zone └── myUserName@tilde.zone ``` See the content of a file ``` $ pass email/tilde.institute/myAccount supersecret ``` Copy the first line to the clipboard. Clear time can be configured with `$PASSWORD_STORE_CLIP_TIME` ``` $ pass -c email/tilde.institute/myAccount Copied email/tilde.institute/myAccount to clipboard. Will clear in 45 seconds. ``` Insert a new password. It can be multiline with `-m`. Remember to put the password on the first line if you want to use the clipboard function ``` $ pass insert sites/foo.com/blah Enter password for sites/foo.com/blah: ``` Generate a 32 chars random password and store it. You can define the default length with `$PASSWORD_STORE_GENERATED_LENGTH`. With `-n` the password will not include symbols, but alphanumeric characters only. With `-c` it gets copied to the clipboard as usual. ``` $ pass generate sites/foo.com/abcd 32 The generated password to sites/foo.com/abcd is: $(-QF&Q=IN2nFBx) ``` take a look at the `--help` option or the complete documentation on their website. ## Changing Keys If you need to change the key being used for your password files, simply navigate to the directory and re-issue `pass init`, but with the ID of the new key to be used. Pass will prompt for the old key's password, then automatically decrypt all keys and re-encrypt them with the new key. ``` $ cd ~/.password-store $ pass init NEWGPGKEYID ``` references: * [pass home page](https://passwordstore.org) [back](/)