Shroud

Shroud is a simple secret manager with a command line interface.

The password database is stored as a Scheme s-expression and encrypted with a GnuPG key. Secrets consist of an arbitrary number of key/value pairs, making Shroud suitable for more than just password storage. For copying and pasting secrets into web browsers and other graphical applications, there is xclip integration.

Usage

First, create a .shroud file in your home directory to hold your configuration settings. All you really need to set here is your GPG user ID i.e. your email address:

'((user-id . "foo@example.com"))

The .shroud file is Scheme source code, so any expression that evaluates to an alist of valid configuration settings is usable by Shroud.

Once Shroud is configured, try out the following commands to get a feel for how things work:

# Add a new secret:
shroud hide bank-account username=foobar password=hackme

# Edit an existing secret:
shroud hide --edit bank-account password=hackmepls

# List all secrets:
shroud list

# Show all key/value pairs for a saved secret:
shroud show bank-account

# Show a single value in a secret:
shroud show bank-account password

# Copy a password directly to X clipboard:
shroud show -c bank-account password

# Delete a secret:
shroud remove bank-account

Happy shrouding!

Releases

Requirements

Installation

To build and install Shroud from source, run:

wget https://files.dthompson.us/releases/shroud/shroud-0.1.1.tar.gz
tar xf shroud-0.1.1.tar.gz
cd shroud-0.1.1
./configure
make
make install

License

GNU GPLv3+

Git Repository

Shroud is developed using the Git version control system. The official repository is hosted at https://git.dthompson.us/shroud.git.

To clone the repository, run:

git clone https://git.dthompson.us/shroud.git

Community

Real-time discussion for Shroud can be found on the #guile channel on the Libera.chat IRC network

Contributing

Send patches and bug reports to davet@gnu.org.