Espresso

This is a simple command-line password manager that uses AES-256-GCM authenticated encryption and Argon2id key derivation

Quickstart

I'll try to update this tab as quickly as possible when releasing a new version, this project might not get as much updates once I'm done with the features I thought of.

First version is out ! you can download the source code by going to the release tab.

Simply run these commands

# Not very elegant but it does the job
git clone https://github.com/hunix443/espresso.git ~/.local/share/espresso

bash ~/.local/share/espresso/install.sh

Guide

This will be the vault's default location, I wouldn't recommend changing it.

~/.espresso-vault/vault.json

By using the owner mods 0600, allowing only you to access its content, except if you're an admin of course.

The vault.json file will look like this :

{
  "version": 1,
  "kdf": {
    "name": "argon2id",
    "salt": "q64/W1JkJ7fg8hEsJSVZvA=="
  },
  "cipher": {
    "name": "aes-256-gcm",
    "nonce": "XCOuDgwctCqHvnI4",
    "ciphertext": "9Heaah09oEZ7PKksKL5AADpV"
  }
}⏎  

🏳️ | Be aware that once you set your master password there is no way to retrieve your password. The only solution is to delete the vault and recreating a new one.

Contributing

Not sure if there are lots of thing to work on with my password manager but still, if y'all wants to add pretty visuals, themes, features that maybe other people may find useful, feel free to fork and open a PR, I'd be extremely happy to see other people contributing to my small project.

Anyway hope this project will help some of y'all. Feel free to use Espresso as a self project for you to build your way in cybersecurity.