keyman 0.1.0rc12

A simple command-line password manager.

Keyman is a utility for storing and managing your passwords locally.

Features

The manager can store an account with following terms recorded (“*” marked term is required):

• title (*): title of the account, e.g. weibo, wechat, facebook

• username: your username

• description: description of the account

• password: your password

• phone: the phone number bound to the account

• email: the email address related to the account

• secret: some secret information

where passwords and secrets are stored in encrypted forms.

IMPORTANT: In spite that encryption procedure is involved, since keyman doesn’t require any certification before it is used to manage (including exhibit and edit) your account records, it is recommended that you store the keywords that can remind you of your password and secret info, rather than the “raw” keywords and secret messages.

Installation

Simply use:

$ pip install keyman

If you are using Anaconda, problems may arise when pip is trying to install pycrypto, which is required by keyman. To deal with this problem, you can use

$ conda install pycrypto

and then use

$ pip install keyman

as usual.

Usage

Below are what can be done with keyman:

• Create a new account record:

  $ keyman insert

  Then follow the instructions to record the account.

• Remove an existing account (accounts):

  $ keyman remove --id IDS_TO_BE_REMOVED

  If --nontrash flag is not given, the record(s) will be moved into trash; Otherwise they will be deleted from the database completely.

• Recover an account (accounts) from trash:

  $ keyman recover --id IDS_TO_BE_RECOVERED

• Search accounts according to given conditions:

  1. search by id’s:

     $ keyman search --id IDS_TO_SEARCH

  2. or search by sub-strings in title and description [1]:

     $ keyman search --title STR_IN_TITLE --description STR_IN_DESC

  If --show-all flag is given, the records found in trash will also be listed out.

  [1]

  The logical relation between arguments --title and --description is “AND”.

• List out all the accounts in certain range [2]:

  $ keyman list --all | --trash | --normal

  [2]

  The three flags are not mutually exclusive. --all will overwrite the rest two flags, and --trash --normal is equivalent to --all.

• Update an existing account by editing its information:

  $ keyman updata --id ID_TO_BE_UPDATED

  Then follow the instructions to update the account.

For command keyman or any sub-command, use --help to get the related help message.