Usage

Lock/Unlock

Use vps lock and vps unlock followed by your sudo password.
This prevents deletion and editing files.
When the password store is locked you can still view your passwords.
But in order to edit, create, move and delete files you need to unlock the store!

VPS command structure:

vps COMMAND PARAMETER --FLAG
sh

VPS uses folders and files to organize your passwords.
When your provide VPS with a PATH and FILE it will be appended onto the password store path.

F.ex:

vps gen web/github.com
sh

...will create a web folder in ~/.vilath and a github.com file.
The file will be encrypted and the entire path will look like this:

/home/$USER/.vilath/web/github.com.gpg
sh

You will never see .gpg extensions or have to use them when you use VPS!

Encryption

VPS will automatically encrypt your password files.
When you f.ex edit a file through VPS, a temporary file is created which will be encrypted and the unencrypted file will be shredded!

Generating password

Generating a random password using openssl, saving it in provided file and encrypting the file.

Alias: gen

vps generate path/file [--copy,-c] | [--length[=password-length],-l[password-length]]
sh

VPS will generate a 32 character password by default if no password-length is provided:

~/.vilath/.bin/generate
openssl rand -base64 ${PASSWORD_LENGTH} | tr -dc 'a-zA-Z0-9!@#$%^&*()_+-={}:<>?[]|~'
bash
1

Hidden files

To generate a hidden directory or file, you just need to append . in front of it.
So if you're REALLY into corn, then you can f.ex. run this command:

vps gen .super-secret-folder/cornhub.website
sh

Listing passwords

Running vps without any command or parameters will list password files.
But if you want to pass any flags when listing files, you need to run one of the following aliases:

Alias: ls

vps list [--all,-a]
sh

VPS supports hidden files and directories, pass the --all flag to list hidden files.
By default these will not be shown by VPS.

Viewing password

VPS will hide the password by default while viewing a file.
Pass the --all flag to view the password file without hiding the password.

Alias: cat

vps view path/file [--all,-a] | [--copy,-c]
sh

Managing passwords

VPS will hide the password by default while editing a file.
Pass the --all flag to edit the password file without hiding the password.

vps edit path/file [--all,-a]
sh

Move password

Move or rename a file within the password store.

Alias: mv

vps move path/source_file path/target_file
sh

Copy password

Copy a file within the password store.

Alias: cp

vps copy path/source_file path/target_file
sh

Delete password

Delete a file or directory within the password store.

Alias: rm

vps remove PATH/FILE
sh
DELETION IS PERMANENT

Deleting a files is NOT reversible!
Even if you can restore the files, the content may be corrupted..