pyKeyring 0.6

A simple and secure tool to store passwords

A simple and secure tool to store passwords

Introdution

pyKeyring is a tool to store encrypted passwords in a simple database file.

Installation

Using pip

You need Python 3 installed on your system.

The latest release can be installed from pypi via pip:

foo@bar:~# pip install pykeyring

Manual Installation

Manual installation allows you to run the latest development version from this repository.

pyKeyring depends on TinyDB and Criptography to run.

You can install pyKeyring with all dependecies by running:

foo@bar:~# python setup.py install

Usage

pyKeyring is very simple to use.

Create a database

foo@bar:~$ keyring.py -f /path/to/keyring.db create

The default database file is named keyring.db. If you don’t use the -f argument, pyKeyring will use this name. You can use the -F argument to specify the storage format, BSON (default) or JSON.

Insert a password

foo@bar:~$ keyring.py add password_label

The password_label is used to label your password :)

Get a password

foo@bar:~$ keyring.py get password_label

If you don’t want to print the password in the terminal you can use the argument -c to copy the password to clipboard.

foo@bar:~$ keyring.py get -c password_label

Update a password

foo@bar:~$ keyring.py update password_label

Remove a password

foo@bar:~$ keyring.py remove password_label

Generate a random password

foo@bar:~$ keyring.py generate

If you want to save this with a label you only need to use the -s (–save) argument.

foo@bar:~$ keyring.py generate -s label

You can limit the characteres used to generate the password using the arguments:

• -l length, –length length

  The length for the generated password [default=12]

• -u, –no-uppercase

  Don’t use uppercase chars in the password

• -ll, –no-lowercase

  Don’t use lowercase chars in the password

• -d, –no-digits

  Don’t use digits in the password

• -p, –no-punctuation

  Don’t use punctuation chars in the password

• -e except_chars, –except-chars except_chars

  Don’t use these chars in the password

To generate an 8 digits password you can use:

foo@bar:~$ keyring.py generate -u -ll -p -l 8