1 5cdf5adc 2022-05-08 op # plass -- manage passwords
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.
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:
14 b0942e5c 2023-01-21 op - pwg(1): password/passphrase generator
15 b0942e5c 2023-01-21 op - totp(1): TOTP generator
17 d6d9ef31 2023-01-02 op To build and install it, execute
20 3c8bc63d 2022-10-05 op $ doas make install
22 db060d76 2023-01-02 op On linux, `libbsd-overlay` must be used:
24 db060d76 2023-01-02 op $ make CFLAGS="$(pkg-config --cflags libbsd-overlay)" \
25 db060d76 2023-01-02 op LDFLAGS="$(pkg-config --libs libbsd-overlay libcrypto)"
26 db060d76 2023-01-02 op $ sudo make install
28 09c3bfe2 2022-10-20 op For casual use, an `install-local` target that only copies the programs
29 09c3bfe2 2022-10-20 op in ~/bin is provided.
32 09c3bfe2 2022-10-20 op At the moment plass is completely compatible with pass, but in the
33 d6d9ef31 2023-01-02 op future the encryption tool may be switched to something different to
39 5cdf5adc 2022-05-08 op plass is free software distributed under the ISC license
41 b0942e5c 2023-01-21 op Copyright (c) 2022, 2023 Omar Polo
43 5cdf5adc 2022-05-08 op Permission to use, copy, modify, and distribute this software for any
44 5cdf5adc 2022-05-08 op purpose with or without fee is hereby granted, provided that the above
45 5cdf5adc 2022-05-08 op copyright notice and this permission notice appear in all copies.
47 5cdf5adc 2022-05-08 op THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
48 5cdf5adc 2022-05-08 op WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
49 5cdf5adc 2022-05-08 op MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
50 5cdf5adc 2022-05-08 op ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
51 5cdf5adc 2022-05-08 op WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
52 5cdf5adc 2022-05-08 op ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
53 5cdf5adc 2022-05-08 op OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
