tREADME - safe - password protected secret keeper
(HTM) git clone git://git.z3bra.org/safe.git
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
tREADME (996B)
---
1 safe
2 ====
3 Password protected secret keeper.
4
5 Secrets are encrypted and stored on disk using a key derivated from your
6 master password. An agent can retain the key in memory so
7 you don't have to type the password over and over.
8
9 Features
10 -----
11 - No keys to manage!
12 - No other files than your secrets
13 - Handle secrets of any size (stream encryption)
14 - Agent-like capabilities
15 - Support external askpass programs
16 - Encrypt secrets in [cream][0] format
17
18 Usage
19 -----
20 Refer to safe(1) manual page for details and examples.
21 The below commands are provided as a quick introduction.
22
23 This will store and retrieve a secret from the safe
24
25 safe -a mysecret < secret.jpg
26 safe mysecret > secret.jpg
27
28 Secrets being standard files in $SAFE_DIR, you can list them using
29 standard tools:
30
31 find ${SAFE_DIR} -type f
32
33 Installation
34 -----
35 Edit config.mk as needed, then build/install with the following commands:
36
37 make
38 make install
39
40 Require [libsodium][1].
41
42 [0]: https://z3bra.org/cream
43 [1]: https://libsodium.org