A simple diceware generator with no dependencies.
git clone https://github.com/avnigo/nodice-cli.git && cd nodice-cli
python -m pip install .
python nodice
Install from package using pip
or pipx
:
pip install nodice-cli
$ nodice --help
usage: nodice [-h] [--words WORDS] [--entropy ENTROPY] [--spacer SPACER] [--dice DICE] [--sides SIDES] [--show-rolls] [--file FILE] [--delimiter DELIMITER] [--verbose]
Generate diceware passphrases from wordlists.
options:
-h, --help show this help message and exit
--words WORDS, -w WORDS number of words (default: `5`)
--entropy ENTROPY, -e ENTROPY set minimum bits of entropy
--spacer SPACER, -s SPACER separate words with a spacer (default: ` `)
--dice DICE, -d DICE number of dice per word; ignores --file and --entropy options
--sides SIDES, -D SIDES number of sides per die (default: `6`)
--show-rolls, -r show dice rolls only
--make-custom, -m generate keys (dice rolls) for custom wordlist
--file FILE, -f FILE diceware dictionary file (default: `wordlists/eff_large_wordlist.txt`)
--delimiter DELIMITER, -t DELIMITER dictionary delimiter (default: $'\t')
--verbose, -v show entropy information
- Running
nodice
orpython -m nodice
without any options falls back to defaults: 5 random words fromeff_large_wordlist.txt
.
$ nodice
anybody desecrate battalion agility skid
- Choosing the number of words to generate:
$ nodice --verbose --words 8
citric trimming whole unlivable drivable percent suitor clump
> 8 random words from a 7776-word list yield 103.4 bits of entropy.
- Setting the minimum bits of entropy for the passphrase will generate the appropriate amount of words:
$ nodice -v --entropy 120 -s"-"
glade-unmoved-pacemaker-gallon-jogging-sculpture-gentleman-disburse-unsaddle-surprise
> 10 random words from a 7776-word list yield 129.2 bits of entropy.
- Only show dice rolls generated based on the provided wordlist:
$ nodice -w 10 --show-rolls --file my_printed_wordlist.txt
21162 54422 55235 46233 61313 62442 21411 23555 54232 55436
- Use a custom delimiter to parse wordlist:
$ nodice -w 7 --show-rolls --file my_wordlist.csv --delimiter ","
23611 62433 55136 12534 55642 51415 13611
- Set the number of dice to roll for each word:
$ nodice -d6 -w 10 -s $'\n'
464645
664516
111426
133531
416231
613133
541445
156546
325161
566625
- Use an alternative EFF wordlist:
$ nodice -v -f nodice/wordlists/eff_short_wordlist_2_0.txt -w 8
goldfish depot unwrinkled tiger caviar rustproof urgent urethane
> 8 random words from a 1296-word list yield 82.7 bits of entropy.
- Set the number of sides of the dice used (e.g. two-sided coin):
$ nodice -v -f nodice/wordlists/bip_0039.txt -w 12 -D2
mountain noble arctic joke hero fruit novel palace quarter genuine rather price
> 12 random words from a 2048-word list yield 132.0 bits of entropy.
It is possible to use custom wordlists, either delimited alongside their corresponding dice rolls, or simply a bare list of words, as in the examples below respectively.
- For delimited wordlists, the defaults apply (i.e., delimiter and number of sides), otherwise they would need to be passed in as arguments.
11111 abacus
11112 abdomen
11113 abdominal
11114 abide
11115 abiding
11116 ability
...
- In the case of a bare wordlist like the one below, dice roll keys for a perfect-power-length wordlist will be generated when possible using smaller than 10-sided dice, whereas other length wordlists are unhandled for now.
abacus
abdomen
abdominal
abide
abiding
ability
...
Using the --make-custom
flag with a bare wordlist creates the wordlist alongside the corresponding keys (dice rolls):
$ nodice --make-custom -t, -f bare_wordlist.txt | tail
66656,zombie
66661,zone
66662,zoning
66663,zookeeper
66664,zoologist
66665,zoology
66666,zoom