summaryrefslogtreecommitdiff
path: root/README.md
blob: 08de240faccf2cf6cfac6f79b071a11d7f6aa0db (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
# Jotpass

The `jotpass` utility facilitates generating random passwords suitable for
handwriting. See [this][intro] blog post for an introduction.

Jotpass' original source code is hosted [here][repo].

[intro]: https://www.skreutz.com/posts/readable-random-passwords-with-jot/
[repo]: https://git.skreutz.com/jotpass.git/

## Usage

Print a random password:

    $ jotpass
    P6ji-4pRZ-Ze7m-q7Bp-Vpye-HCjr-hygF-6TwQ-oRJT-yx6p-SyMB-AwUm

See the manual page for details.

## Dependencies

The `jotpass` utility depends on `ksh(1)`, `jot(1)`, and some base utilities
like `sed(1)`.

On OpenBSD these are included in the default base installation.

On Void Linux you can install the dependencies using `xbps-install(1)`:
follows:

    $ sudo xbps-install -S oksh outils coreutils bc sed

## Installation

    $ ./configure
    $ make
    $ sudo make install

There's also an experimental Nix flake:

    $ nix run git+https://git.skreutz.com/jotpass.git/?ref=nix
Generated by cgit. See skreutz.com for my tech blog and contact information.