Skip to main content

Simple console password manager using json as backend

Project description

Passwdk is simple console password manager that uses single json file as it’s backend.


Start passwdk using:

$ passwdk --help
usage: passwdk [-h] {add,get}

positional arguments:
  {add,get}   action to take

optional arguments:
  -h, --help  show this help message and exit

Add password

Add new password to password file using:

$ passwdk add --help
usage: passwdk add arguments

optional arguments:
  -h, --help          show this help message and exit
  -n NAME             password name
  -u USER             user name
  -e EMAIL            email
  -o NAME VALUE       other informations
  -t TAGS [TAGS ...]  password tags

Only name is required. Other information may be provided multiple times to store whatever information on password entry. You will be prompted for password. If you want to generate that use application designed to do that, e.g. pwgen.

After saving changes to password file POST_ADD_HOOK is executed (if defined). It can be used to e.g. commit changes to git repository storing password file (see passwdkrc.sample). NEW_PASSWORD_NAME and PASSWD_FILE env variable can be used in that hook.

Get password entries

Find password entries by search terms using:

$ passwdk get --help
usage: passwdk get search terms

positional arguments:
  search      search terms

optional arguments:
  -h, --help  show this help message and exit
  -p          only password without ending new-line

At least one search term is required. It will print either entries with name equal to one of the search terms or with tags including all search terms.


Passwdk configuration is stored in $HOME/.passwdkrc file. See sample configuration file.


Passwdk currently is developed and tested on Linux using Python 2.7.


The latest version is available to install using pip:

$ pip install

Zsh completion

To install Zsh completion copy _passwdk file to directory listed in $fpath (see zsh-completions-howto).

Project details

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page