NAME

       assword - Simple and secure password database and retrieval system

SYNOPSIS

       assword <command> [<args>...]

DESCRIPTION

       Commands:

       add [<context>]
              Add  a new entry.  If context is '-' read from stdin.  If not specified, user will be prompted for
              context.  See ASSWORD_PASSWORD for information on passwords.

       dump [<string>]
              Dump search results as json.  If string not specified all entries are  returned.   Passwords  will
              not be displayed unless ASSWORD_DUMP_PASSWORDS is set.

       gui [<string>]
              GUI interface, good for X11 window manager integration.  Upon invocation the user will be prompted
              to  decrypt  the  database,  after  which  a  graphical  search  prompt  will be presented.  If an
              additional string is provided, it will be added  as  the  initial  search  string.   All  matching
              results for the query will be presented to the user.  When a result is selected, the password will
              be  retrieved according to the method specified by ASSWORD_XPASTE.  If no match is found, the user
              has the  opportunity  to  generate  and  store  a  new  password,  which  is  then  delivered  via
              ASSWORD_XPASTE.

       remove <context>
              Delete an entry from the database.

       version
              Report the version of this program.

       help   This help.

ENVIRONMENT

       ASSWORD_DB
              Path to assword database file.  Default: ~/.assword/db

       ASSWORD_KEYFILE
              File containing OpenPGP key ID of database encryption recipient.  Default: ~/.assword/keyid

       ASSWORD_KEYID
              OpenPGP key ID of database encryption recipient.  This overrides ASSWORD_KEYFILE if set.

       ASSWORD_PASSWORD
              For  new  entries,  entropy of auto-generated password in bytes (actual generated password will be
              longer due to base64 encoding). If set to  'prompt'  user  will  be  prompted  for  for  password.
              Default: 18

              ASSWORD_DUMP_PASSWORDS Include passwords in dump when set.

       ASSWORD_XPASTE
              Method  for  password retrieval.  Options are: 'xdo', which attempts to type the password into the
              window that had focus on launch, or 'xclip'  which  inserts  the  password  in  the  X  clipboard.
              Default: xdo

assword assword                                     May 2013                                          ASSWORD(1)