Usage - AntonVanAssche/BashPass GitHub Wiki
This page provides instructions on how to use BashPass.
1. Basic Command Structure
Usage: bashpass [OPTION] [NAME | SYNC_COMMAND]
Options:
--help | -h Show this help message.
--version | -v Show the version number.
--add | -a [NAME] Add a password.
--copy | -c [NAME] Copy a password to the clipboard.
--delete | -d [NAME] Delete a password.
--show | -s [NAME] Show a password.
--update | -u [NAME] Update a password.
--list | -l List all passwords.
--sync | -S [SYNC_COMMAND] Synchronize password(s) with a git repository.
Synchronize commands:
upload Upload local password(s) to a remote repository.
download Download password(s) from a remote repository.
Note:
[NAME] is an optional argument. If not provided, the script will prompt you to enter it.
2. Options
--help
| -h
2.1 Show a brief help message.
--version
| -v
2.2 Display the version number of your BashPass installation.
--add
| -a
2.3 Add a new password to the system. The password can be either self-chosen or auto-generated.
If no NAME
is specified, BashPass will ask for it.
$ bashpass --add gmail
--copy
| -c
2.2 Copy the password of the specified NAME
to the clipboard.
The clipboard will be cleared after a certain amount of time, specified in the configuration file.
$ bashpass --copy gmail
--delete
| -d
2.3 :warning: Be careful, BashPass will not ask for confirmation!
Delete the password of the specified NAME
from the system.
$ bashpass --delete gmail
--show
| -s
2.4 :warning: BashPass wil print the password in clear text to the terminal.
Print the password of the specified NAME to stdout.
$ bashpass --show gmail
--update
| -u
2.5 :warning: BashPass will overwrite the previous password!
Update the password of the specified NAME
.
The password can be either self-chosen or auto-generated.
$ bashpass --update gmail
--list
| -l
2.6 List all the names of the passwords stored in the password store.
$ bashpass --list
--sync
| -S
2.7 :warning: The password store must be initialized with a remote Git repository before using this command.
Sync the password store with a remote Git repository.
The SYNC_COMMAND
can be either upload
or download
.
$ bashpass --sync upload
$ bashpass --sync download