;;;;;
title: dispass.el
url: projects/dispass.el.html
;;;;;

## What does it do?

[DisPass](http://dispass.babab.nl) is a passphrase generator.
`dispass.el` is an [Emacs](http://gnu.org/software/emacs) wrapper for
DisPass. It tries to improve upon the user interface(s) provided by
DisPass by being an Emacs module, automatically copying generated
passphrases to your clipboard, providing label completion and enabling
easy management of labels.

DisPass is written by a [friend](http://babab.nl) of mine and I really
liked the idea of it. But the interface he had for it was not to my
liking: it was not Emacs.

It offers:

- Copying passwords directly to the clipboard, no need for manual
  selection and copying.

- Specifying the length of the passphrase by using a numeric prefix
  argument.

- Input completion for labels.

- Some label management (adding, removing).

## Alternatives

DisPass provides its own command-line-based interface and a Tk-based
GUI and I also have a [Conkeror](http://conkeror.org) interface
project for it. These all suffer from not being Emacs modules and are
thus unusable.

## Requirements

Obviously it requires both [DisPass](http://dispass.babab.nl) and
[Emacs](http://gnu.org/software/emacs). Beyond that there shouldn't be
any requirements.

## Download

You can browse the
[git source](https://github.com/dispass/dispass.el), download a
snapshot
[tar.gz](https://github.com/dispass/dispass.el/archive/master.tar.gz)
or [zip](https://github.com/dispass/dispass.el/archive/master.zip)
archive or install a snapshot using
[MELPA](http://melpa.milkbox.net/). #Note:# The snapshots require a
recent snapshot from the DisPass git sources, they won't work with the
latest DisPass release.

You can download the latest release, v1.1.2, as a
[tar.gz](https://github.com/dispass/dispass.el/archive/1.1.2.tar.gz)
or [zip](https://github.com/dispass/dispass.el/archive/1.1.2.zip)
archive or install it using [Marmalade](http://marmalade-repo.org).
**Note:** v1.1.2 needs DisPass v0.2.0, it won't work with recent
snapshots from the git sources.

## License

dispass.el is released under the ISC license. The license can be found
in the header of the
[source](https://github.com/dispass/dispass.el/blob/master/dispass.el)
file (or follow the link).

Since DisPass uses the ISC license, I thought it would be polite to
use the same license.

## Documentation

For further instructions on how to use dispass.el, see the
[README](https://github.com/dispass/dispass.el/blob/master/README.org)
in the source directory (or follow the link).

## Contact

If you find any bugs, have suggestions or criticisms you can send them
to [tom@ryuslash.org](mailto:tom@ryuslash.org) or send a message to
the [dispass@librelist.com](mailto:dispass@librelist.com) mailing list
(your first message is your registration and will be dropped).

<!-- Local Variables: -->
<!-- mode: markdown -->
<!-- End: -->
