Diceware passphrase generator built with Python.

• About
• Installation
• Usage
  • Number of Words
  • Delimiter
  • Capitalisation
  • Quiet Mode
• Security
  • Passphrase Length
  • Randomness
• Licence

Diceware is a method for generating random, strong and memorable passphrases created by Arnold G. Reinhold.

The original method uses ordinary physical dice to generate random five digit numbers. You look up each number in a special list called the Diceware Word List to find the corresponding word. These random words are your new passphrase.

py-diceware is a command line interface tool for generating passphrases based on the Diceware method.

Install py-diceware using pip:

pip install py-diceware

To learn more about installing Python packages, refer to the Installation Tutorial from PyPI.

Once installed, use --help to list all the available options:

$ py-diceware --help
Usage: py-diceware [OPTIONS]

  Diceware passphrase generator.

Options:
  -w, --words INTEGER RANGE  Number of words for passphrase.  [default: 6;
                             x>=1]
  -d, --delimiter TEXT       Delimiter to separate words in passphrase.
  --caps / --no-caps         Capitalise words in passphrase.  [default: caps]
  -q, --quiet                Only output the passphrase. Silence prompts and
                             other output.
  --help                     Show this message and exit.

You can specify the number of words for the passphrase with the -w option:

$ py-diceware -w 8

#...

Your passphrase is:
UsdaChiveAlaskaWareTwSethShuckDeform

You will be prompted for the number of words if not provided from the command line:

$ py-diceware
Number of words [6]:

#...

The default number of words for the passphrase is 6, which is what is recommended for most users.

For more information about recommended passphrase lengths, refer to the 'How long should my passphrase be?' section on the original Diceware FAQ.

By default the words in the passphrase will not be separated by any delimiter (or more accurately, the default delimiter is just an empty string).

You can specify a delimiter for the passphrase with the -d option:

$ py-diceware -w 6 -d "_"

#...

Your passphrase is:
Spasm_Windy_Teet_Straw_Punish_Dj

The original Diceware method recommends separating each word with a space, however this is not the default for py-diceware just based on the author's personal preference. This also allows for quick copying of the passphrase with a double-click on Linux systems.

It could be argued that without any delimiter, the passphrase entropy is slightly reduced due to redundancy; for example, the words "in put clammy" and "input clam my" would generate the same passphrase. However, py-diceware mitigates this problem by capitalising each word by default (see the Capitalisation section below).

If you would prefer to generate a passphrase as recommended by the original Diceware method, simply specify a space as the delimiter and no capitalisation of words:

$ py-diceware -w 6 -d " " --no-caps

#...

Your passphrase is:
flick aura junky meter alien throb

By default each word in the passphrase will be capitalised.

You can specify whether to capitalise words with the -caps or --no-caps option:

$ py-diceware -w 6 -d " " --no-caps

#...

Your passphrase is:
flick aura junky meter alien throb

All words in the Diceware list are lower case, and the original method does not recommend capitalising words as arguably this does make the passphrase slightly more difficult to type (and harder to remember if characters are capitalised randomly, though this is not applicable for py-diceware).

However, the Diceware FAQ does note exceptions where some system password policies "insist that you use a mix of uppercase and lower case letters" or "where the length of the password is limited to 15 characters".

If you would prefer to generate a passphrase as recommended by the original Diceware method, simply specify a space as the delimiter and no capitalisation of words like the example above.

It is recommended to use a delimiter if you choose not to capitalise the passphrase words, otherwise this could slightly reduce the passphrase entropy as discussed above in the Delimiter section.

You can use the --quiet option to only output the passphrase and silence any prompts and other output:

$ py-diceware -w 8 -q
UsdaChiveAlaskaWareTwSethShuckDeform

If the number of words is not provided from the command line in quiet mode, the generated passphrase will use the default of 6 words which is recommended for most users (see the above Number of Words section for more info).

Warning Use py-diceware to generate passphrases at your own risk.

According to the Diceware FAQ, the Diceware method is secure even if an attacker knows:

• that you used Diceware to pick your passphrase
• the number of words in your passphrase
• the word list used.

The security of the Diceware method is based on "the huge number of combinations that an attacker must search through, even with that knowledge".

A six word passphrase is recommended for most users, which is the default for py-diceware if the number of words is not provided.

For more information about recommended passphrase lengths, refer to the 'How long should my passphrase be?' section on the original Diceware FAQ.

The original Diceware method recommends starting over if the generated passphrase is shorter than 19 characters. Because some words on the diceware list are two characters or less, it is possible to generate a very short passphrase.

Although extremely rare, you should also start over if your passphrase is a recognisable sentence or phrase.

py-diceware utilises Python's secrets module, which is used for "generating cryptographically strong random numbers suitable for managing data such as passwords, account authentication, security tokens, and related secrets".

This is opposed to the random module, which is sometimes dangerously suggested for generating sensitive information such as passwords. The random module generates only pseudo-random numbers and is designed for modelling and simulation, not security or cryptography.

See PEP 506 for more info.

The original Diceware method recommends: "Do not use a computer program or electronic dice generator. There is no easy way to be sure they are random enough."

The secrets module documentation advises that it "provides access to the most secure source of randomness that your operating system provides".

If you are concerned about maximum security, do not use py-diceware. Instead follow the Diceware method using real dice.

Licensed under the GNU General Public License v3.0.