Blame


1 5cdf5adc 2022-05-08 op # plass -- manage passwords
2 5cdf5adc 2022-05-08 op
3 b0942e5c 2023-01-21 op plass is a password manager inspired by password-store in the essence
4 b0942e5c 2023-01-21 op but completely reimplemented with a smaller and (IMO) cleaner interface.
5 b0942e5c 2023-01-21 op It doesn't have fancy trees nor colors in the output; the absence of
6 b0942e5c 2023-01-21 op these is considered a feature. It aims to stay closer to the "UNIX
7 b0942e5c 2023-01-21 op phylosophy" by trying to do one thing only and to it (hopefully) well.
8 5cdf5adc 2022-05-08 op
9 b0942e5c 2023-01-21 op With plass every password lives inside a gpg(1) encrypted file somewhere
10 b0942e5c 2023-01-21 op inside `~/.password-store` which is managed with the got(1) VCS to keep
11 b0942e5c 2023-01-21 op track changes, recovery accidental overwrites and synchronize it across
12 b0942e5c 2023-01-21 op devices. Two helper utilities are bundled:
13 5cdf5adc 2022-05-08 op
14 b0942e5c 2023-01-21 op - pwg(1): password/passphrase generator
15 b0942e5c 2023-01-21 op - totp(1): TOTP generator
16 b0942e5c 2023-01-21 op
17 d6d9ef31 2023-01-02 op To build and install it, execute
18 3c8bc63d 2022-10-05 op
19 09c3bfe2 2022-10-20 op $ make
20 3c8bc63d 2022-10-05 op $ doas make install
21 3c8bc63d 2022-10-05 op
22 09c3bfe2 2022-10-20 op For casual use, an `install-local` target that only copies the programs
23 09c3bfe2 2022-10-20 op in ~/bin is provided.
24 3c8bc63d 2022-10-05 op
25 3c8bc63d 2022-10-05 op
26 09c3bfe2 2022-10-20 op At the moment plass is completely compatible with pass, but in the
27 d6d9ef31 2023-01-02 op future the encryption tool may be switched to something different to
28 09c3bfe2 2022-10-20 op gpg.
29 5cdf5adc 2022-05-08 op
30 5cdf5adc 2022-05-08 op
31 5cdf5adc 2022-05-08 op ## License
32 5cdf5adc 2022-05-08 op
33 5cdf5adc 2022-05-08 op plass is free software distributed under the ISC license
34 5cdf5adc 2022-05-08 op
35 b0942e5c 2023-01-21 op Copyright (c) 2022, 2023 Omar Polo
36 5cdf5adc 2022-05-08 op
37 5cdf5adc 2022-05-08 op Permission to use, copy, modify, and distribute this software for any
38 5cdf5adc 2022-05-08 op purpose with or without fee is hereby granted, provided that the above
39 5cdf5adc 2022-05-08 op copyright notice and this permission notice appear in all copies.
40 5cdf5adc 2022-05-08 op
41 5cdf5adc 2022-05-08 op THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
42 5cdf5adc 2022-05-08 op WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
43 5cdf5adc 2022-05-08 op MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
44 5cdf5adc 2022-05-08 op ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
45 5cdf5adc 2022-05-08 op WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
46 5cdf5adc 2022-05-08 op ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
47 5cdf5adc 2022-05-08 op OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
48 5cdf5adc 2022-05-08 op