Assword - simple and secure password management system
======================================================

Assword is a secure password manager that relies on your OpenPGP key
for security and is designed to integrate in a minimal fashion into
any X11 window manager.

Passwords and context strings are stored in a single OpenPGP-encrypted
and signed file (meaning entry contexts are not exposed to the
filesystem).  Along with a simple command-line interface, there is a
streamlined GUI meant for X11 window manager integration.  When
invoked, the GUI produces a prompt to search stored contexts.  New
entries can also easily be created.  Passwords are securely retrieved
without displaying on the screen.  Multiple retrieval methods are
available, including auto-typing them directly into an X11 window
(default), or inserting them into the X11 clipboard.


Contact
=======

Assword was written by:

    Jameson Graef Rollins <jrollins@finestructure.net>
    Daniel Kahn Gillmor <dkg@fifthhorseman.net>

Assword has a mailing list:

    assword@lists.mayfirst.org
    https://lists.mayfirst.org/mailman/listinfo/assword

We also hang out on IRC:

    channel: #assword
    server:  irc.oftc.net


Getting Assword
===============

Source
------

Clone the repo:

    $ git clone git://finestructure.net/assword
    $ cd assword

Dependencies :
  * python3
  * python3-gpgme - Python wrapper for the GPGME library
  * python3-gtk2 - Python bindings for the GTK+ widget set
  * python3-pkg-resources - Package Discovery and Resource Access

Recommends (for curses UI) :
  * python3-xdo - Support for simulating X11 input (libxdo bindings)
  * xclip - Support for accessing X11 clipboard

Debian
------

Assword is now available in Debian: https://packages.qa.debian.org/assword

Debian/Ubuntu snapshot packages can also be easily made from the git
source.  You can build the package from any branch but it requires an
up-to-date local branch of origin/debian, e.g.:

    $ git branch debian origin/debian

Then:

    $ sudo apt-get install build-essential devscripts pkg-config python3-all-dev python3-setuptools debhelper dpkg-dev fakeroot
    $ make debian-snapshot
    $ sudo apt-get install python3-gpgme python3-gi python3-pkg-resources python3-xdo xclip
    $ sudo dpkg -i build/assword_0.*_amd64.deb


Using Assword
=============

See the included assword(1) man page or built-in help string for
detailed usage.