# Jotpass

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

The 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

* [OpenBSD][]'s public domain Korn shell, specifically, the portable version
  [oksh][]
* `jot(1)`

and several standard utilities such as `sed(1)`.

On OpenBSD these are included in the default base installation:

    $ doas ln -s /bin/ksh /usr/local/bin/oksh

On FreeBSD you can install the dependencies using `pkg-install(8)`:

    $ sudo pkg install oksh

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

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

## Installation

    $ ./configure
    $ make
    $ sudo make install