CLI password manager

Mike 722bd74d96 fix readme.md 3 months ago
.assets 7c47bd45cc Added demo gif 3 months ago
src e39aafbc7c remove requirements fzflib. 4 months ago
.gitignore 8e64bca8af Fix config exit 5 months ago
LICENSE 4d0801c2a0 init and added code 5 months ago
README.md 722bd74d96 fix readme.md 3 months ago

README.md

ARCALVUS

***A simple password manager that uses GPG for encryption. As a database, it uses just files for convenient data transfer. By default, GPG keys are used for encryption, but you can also choose symmetric encryption.***


  1. Install
  2. Use via Python
  3. Options
  4. Instructions for use
  5. Examples


Depends:

  • fzf
  • gnupg
  • python >= 3.10


Install:

Download the package for your system

Apt:

apt install ./package.deb

Pacman:

pacman -U package.pkg.tar.zst


Use via Python:

git clone 'https://notabug.org/Imitatory/arcalvus'

cd arcalvus/src

python -m venv venv; source venv/bin/activate

pip install -r requirements.txt

chmod +x arcalvus

./arcalvus


Option lists:

flags extendeds deskriptions
-p --get-password get password
-l --get-login get login
-o --get-otp get OTP
-g <key> --get <key> get value <key>
-S <storage_name> --set-storage <storage_name> set storage name
-C --create-storage create new storage
--open open storage
--init init new config
--show show output
--config <path> set config path


Instructions for use:

$HOME/.config/arcalvus/arcalvus.json  #config file
$HOME/Documents/.arcalvus             #default storage path

The config file is created automatically the first time the config is posted, if you want to regenerate the config use the --init option.

By default, Arcalvus uses GPG keys, which you will need to specify when creating a config file.

You can create a key with the command:

gpg --full-generate-key     #Create GPG key
gpg -k                      #List Publick keys

WARNING, in order to avoid errors related to keys, use as a GPG_ID not mail, but fgp, it can be found out when displaying a list of keys.

when the first start was successful and a config file was created, You can already use 'Arcalvus', before using it you can choose a symmetric encryption algorithm, it is enabled in the config file.

{
	"CIPHER": "AES256"   #AES256 Usage.
}
{
	"CIPHER": "GPG"      #This option defaults to using keys.
}
{
	"CIPHER": "GPG_SYM"  #Same as AES256.
}

WARNING: Use only one option.


Create new storage:

arcalvus -C                #Create new storage
arcalvus -CS 'MyPassword'  #Create a storage named 'MyPassword'

This will open an editor where you can enter data, type 'help' for help.


Examples:

Demo: