# DisPass

Author: Benjamin Althues Copyright 2011-2012, Benjamin Althues. 2012/05/28

DisPass is a passphrase generator for Windows and Unix / Linux. You can use it to create unique passwords for logging in to websites, servers or any other kind of thing that requires login. DisPass does not keep your passwords in a database but rather lets you generate a unique passphrase formed from a master password and a label. It is a command line app, but also has a simple graphical interface.

The recommended way is to download and install directly from the PyPI repository using pip.

$sudo pip install dispass  You must have python's docutils installed in able to do so. This will install the dispass module in python's dist-packages folder. You can now run dispass using the 'dispass' and 'gdispass' scripts placed under '/usr/local/bin/' or '/usr/bin/'. The PyPI project page is at http://pypi.python.org/pypi/DisPass/ ### Latest (development) version Clone git repo: $ git clone git://github.com/babab/DisPass.git
$cd dispass  Then you can either 1. Install through pip: $ python setup.py sdist
$sudo pip install doc/  2. Install manually: $ sudo python setup.py install


## Update or uninstall

$sudo pip install dispass --upgrade  If you have installed dispass using pip with, you can easily uninstall at any moment: $ sudo pip uninstall dispass


## Using the command line app

label

The label is a string that you use to identify the password. i.e. this can be a domainname of the service the password is used for like 'google.com'.

This is a master password that, together with the label is used to generate the passphrase.

### Unix/Linux/Mac

DisPass 0.1(posix) - http://dispass.babab.nl/

When DisPass is executed as 'gdispass' or 'dispass -g',
the graphical version will be started.

USAGE: dispass [-co] label [label2] [label3] [...]
dispass -g | -h | -V
gdispass

Options:
-c, --create    use if this passphrase is new (check input PW)
-g, --gui       start guided graphical version of DisPass
-h, --help      show this help and exit
-o, --output    output passphrases to stdout (instead of the
more secure way of displaying via curses)
-V, --version   show full version information and exit


### Windows

DisPass 0.1(nt) - http://dispass.babab.nl/

When DisPass is started without arguments, the graphical
version will be started. To use the command line,
submit one or more labels.

USAGE: dispass [options] [label] [label2] [label3] [...]

Options:
-c, --create    use if this passphrase is new (check input PW)
-h, --help      show this help and exit
-V, --version   show full version information and exit


## Using the graphical version

No info yet.

Copyright (c) 2011-2012 Benjamin Althues <benjamin@babab.nl>

Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.