Super simple app for generating very strong memorable passwords.
Stephen Starkey, ACC f24c1af054 Added easy-to-use entropy calculation function 2 weeks ago
dev-resources Added ITL tests 2 months ago
docs Forgot to commit the marginalia! 2 months ago
resources Added EFF wordlist. 7 months ago
src/dicegen Added easy-to-use entropy calculation function 2 weeks ago
test/dicegen Removed redundant tests. Added some docs. 2 months ago
.gitignore Better docs 6 months ago
LICENSE Revamped to a command-line tool and reusable library 7 months ago
README.md Added ITL tests 2 months ago
build_and_deploy Added ITL tests 2 months ago
build_docs Added ITL tests 2 months ago
dicegen Added ITL tests 2 months ago
project.clj Added easy-to-use entropy calculation function 2 weeks ago

README.md

dicegen

Super simple library for generating very strong, memorable passphrases.

Clojars Project

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/.