dicegen

Super simple library for generating very strong, memorable passphrases.

• Test Results
• API Documentation

Installing

Using homebrew for Mac OS

1. Install homebrew
2. Run: brew tap scstarkey/homebrew-scstarkey https://git.calmabiding.me/scstarkey/homebrew-scstarkey
3. Run: brew install dicegen

Using inlein directly

1. Install inlein
2. Run the following: curl https://git.calmabiding.me/scstarkey/dicegen/raw/branch/master/dicegen -o ~/bin/dicegen && chmod +x ~/bin/dicegen

Tests

exec::use[ns=dicegen.itl.fixtures]

If you run lein itl, the following table will be executed:

Index	Phrase	Entropy	Count	Strong?
0			5	true
1			5	true
2			5	true
3			5	true
4			5	true
table::passwords[wordlist=eff,words=5,phrases=5,min-entropy=60]

Running the application

After installing using the above methods

Run dicegen --help for a description of various options you can pass.

The wordlist option is possibly confusing. The two wordlists we support are:

• Diceware wordlist using diceware or the newer
• EFF wordlist using eff

Directly from source control

1. Install leiningen (you can use homebrew)
2. lein run

Packaging and running as standalone jar

lein do clean, uberjar && java -jar target/dicegen.jar

Building

You'll need at least Java 8 and Leiningen

License

Copyright © 2019, Stephen Starkey.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.