71 lines
2.9 KiB
Org Mode
71 lines
2.9 KiB
Org Mode
|
#+TITLE: dispass.el
|
||
|
|
#+STARTUP: showall
|
||
|
|
#+MACRO: version 1.1.2
|
||
|
|
|
||
|
|
* What does it do?
|
||
|
|
|
||
|
|
[[http://dispass.babab.nl][DisPass]] is a passphrase generator. ~dispass.el~ is an [[http://gnu.org/software/emacs][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 [[http://babab.nl][friend]] 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 [[http://conkeror.org][Conkeror]] interface project for it. These all
|
||
|
|
suffer from not being Emacs modules and are thus unusable.
|
||
|
|
|
||
|
|
* Requirements
|
||
|
|
|
||
|
|
Obviously it requires both [[http://dispass.babab.nl][DisPass]] and [[http://gnu.org/software/emacs][Emacs]]. Beyond that there
|
||
|
|
shouldn't be any requirements.
|
||
|
|
|
||
|
|
* Download
|
||
|
|
|
||
|
|
You can browse the [[https://github.com/dispass/dispass.el][git source]], download a snapshot [[https://github.com/dispass/dispass.el/archive/master.tar.gz][tar.gz]] or [[https://github.com/dispass/dispass.el/archive/master.zip][zip]]
|
||
|
|
archive or install a snapshot using [[http://melpa.milkbox.net/][MELPA]]. *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, v{{{version}}}, as a [[https://github.com/dispass/dispass.el/archive/1.1.2.tar.gz][tar.gz]] or
|
||
|
|
[[https://github.com/dispass/dispass.el/archive/1.1.2.zip][zip]] archive or install it using [[http://marmalade-repo.org][Marmalade]]. *Note:* v{{{version}}}
|
||
|
|
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 [[https://github.com/dispass/dispass.el/blob/master/dispass.el][source]] 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 [[https://github.com/dispass/dispass.el/blob/master/README.org][README]]
|
||
|
|
in the source directory (or follow the link).
|
||
|
|
|
||
|
|
* Contact
|
||
|
|
|
||
|
|
If you find any bugs, have suggestions or criticisms you can send
|
||
|
|
them to [[mailto:tom@ryuslash.org][tom@ryuslash.org]] or send a message to the
|
||
|
|
[[mailto:dispass@librelist.com][dispass@librelist.com]] mailing list (your first message is your
|
||
|
|
registration and will be dropped).
|