summaryrefslogtreecommitdiffstats
path: root/projects/dispass.el.org
blob: c04c267144ac160b4819bc4359a2e5e9d247b3c4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
#+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).