# Bonewords

Password generator that is compatible with a method for generating
passwords using dice rolls.


## Description

This is a software program for generating random passwords that is
compatible with a method I wrote about in a blog post titled "Using
Dice to Generate Human Readable Passwords" which is linked below
(blog post available over HTTP(S), Gopher, and Gemini).  This program
is called "Bonewords" because "bones" are another word for "dice" and
"words" comes from "passwords" in this case, so (dice) + pass"words"
is "bonewords".

### HTTP(S) links to blog post
http://vigrey.com/blog/using-dice-to-generate-human-readable-passwords
https://vigrey.com/blog/using-dice-to-generate-human-readable-passwords

### HTTP(S) "text-only" links to blog post
http://text.vigrey.com/blog/using-dice-to-generate-human-readable-passwords
https://text.vigrey.com/blog/using-dice-to-generate-human-readable-passwords

### Gopher link to blog post
gopher://vigrey.com/blog/using-dice-to-generate-human-readable-passwords

### Gemini link to blog post
gemini://vigrey.com/blog/using-dice-to-generate-human-readable-passwords


## OS Dependencies

Bonewords is meant to build and run on Linux and Plan9, although it
will likely run just fine on macOS, the BSDs, and Windows as well.


## Build Dependencies

- go >= 1.20


## Build Bonewords on Linux

To build Bonewords on Linux, from the root directory of this
repository, run the following command:

```
make
```

The resulting binary file will be at `build/bin/bonewords`.


## Build Bonewords on Plan9

To build Bonewords on Plan9, from the root directory of this
repository, run the following commands:

```
mkdir -p build/bin
cd src
go build
mv src ../build/bin/bonewords
cd ..
```

The resulting binary file will be at `build/bin/bonewords`.