1 # plass -- manage passwords
2 
3 plass is a password manager inspired by password-store but reimplemented
4 with a smaller and (IMHO) cleaner interface.  It doesn't have fancy
5 trees nor colors in the output; the absence of these is considered a
6 feature.
7 
8 In addition, plass uses got(1) to manage the password store and bundles
9 a small utility to generate TOTP codes: totp(1).  Password generation is
10 done with a separate, but bundled, utility: pwg(1).
11 
12 To build and install it, execute
13 
14 	$ make
15 	$ doas make install
16 
17 On linux, `libbsd-overlay` must be used:
18 
19 	$ make CFLAGS="$(pkg-config --cflags libbsd-overlay)" \
20 		LDFLAGS="$(pkg-config --libs libbsd-overlay libcrypto)"
21 	$ sudo make install
22 
23 For casual use, an `install-local` target that only copies the programs
24 in ~/bin is provided.
25 
26 
27 At the moment plass is completely compatible with pass, but in the
28 future the encryption tool may be switched to something different to
29 gpg.
30 
31 
32 ## License
33 
34 plass is free software distributed under the ISC license
35 
36 	Copyright (c) 2022 Omar Polo
37 
38 	Permission to use, copy, modify, and distribute this software for any
39 	purpose with or without fee is hereby granted, provided that the above
40 	copyright notice and this permission notice appear in all copies.
41 
42 	THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
43 	WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
44 	MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
45 	ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
46 	WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
47 	ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
48 	OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
49