A simple password manager written in POSIX shell.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Shokara Kou 479f4b920a add generate to ksh tab-complete 1 month ago
contrib add generate to ksh tab-complete 1 month ago
.gitignore add generate function and contrib/random script 2 months ago
LICENSE initial payload 1 year ago
README add generate function and contrib/random script 2 months ago
angou add generate function and contrib/random script 2 months ago
angou.1 add man page 1 year ago

README

angou (暗号)
============
A simple password manager written in POSIX shell.

Dependencies
------------
- POSIX-compliant environment
- age, gnupg, or any other utility to {en,de}crypt files
- tree (for listing all your passwords and their directories)
- a simple version is available in https://github.com/pyr/tree
and in OpenBSD's ports
- can possibly be replaced with ls if you add ANGOU_LIST in your ~/.profile
- xsel (for copying password to clipboard, but can be changed to a different
command with the ANGOU_CLIPBOARD command that accepts stdin)
- a password generator
- script uses contrib/random from this repo by default and expects it in your
path
- can change by setting ANGOU_GEN_USER and ANGOU_GEN_PASS in your ~/.profile

Configuration
-------------
In your ~/.profile or wherever you set environment variables, add something
like this if you use age:
export AGE_KEY=/nas/ssh/id_ed25519
export AGE_PUB=${AGE_KEY}.pub
export ANGOU_DIR=/nas/angou-age
export ANGOU_ENCRYPT="age -R $AGE_PUB"
export ANGOU_DECRYPT="age -d -i $AGE_KEY -o -"

If you use GnuPG, then add:
export GPG_ID="user@email.tld" # or your key id
export ANGOU_DECRYPT="gpg -qd"
export ANGOU_ENCRYPT="gpg -er $GPG_ID -o -"

For some other file encryptor, you'd need to be able to output the encrypted
file to stdout or change the last line of edit() that runs $ANGOU_ENCRYPT.

Why should I use this over password-store?
------------------------------------------
Don't. For a serious answer, it's because this doesn't depend on bash.

Migrating from password-store
-----------------------------
Set the ANGOU_DIR environment variable to your password store directory.

Auto-complete
-------------
If you use ksh, all you'd have to do is source contrib/autocomplete.ksh in your
kshrc.