diceware - Man Page
diceware [OPTION]... [FILE]
diceware generates passphrases by concatenating words randomly picked from wordlists. It supports also real dice for passphrase generation.
It is based on the proposals of Arnold G. Reinhold on http://diceware.com.
optional input wordlist. '-' will read from stdin. Should contain one word per line.
- -h, --help
show help message and exit
- -n NUM, --num NUM
number of words to concatenate. Default 6
- -c, --caps
Capitalize words. This is the default.
Turn off capitalization.
- -s NUM, --specials NUM
Insert NUM special chars into generated word.
- -d DELIMITER, --delimiter DELIMITER
Separate words by DELIMITER. Empty string by default.
- -r SOURCE, --randomsource SOURCE
Get randomness from this source. Possible values: realdice, system. Default: system
- -w NAME, --wordlist NAME
Use words from this wordlist. Possible values: en, en_eff, en_orig, en_securedrop. Wordlists are stored in the folder displayed below. Default: en_eff
- -v, --verbose
Be verbose. Use several times for increased verbosity.
output version information and exit.
Arguments related to realdice randomsource:
- --dice-sides N
Number of sides of dice. Default: 6
Your personal diceware configuration file.
diceware also comes with a set of wordlists. The path where these lists are stored is showed with --help.
Create a passphrase using defaults. Outputs something like "WheelDyeHonkCanvasWitsPuck"
- diceware -d "-" -n 3
Create a passphrase with three words, separated by dash ("-"). Results in something like "Wheel-Dye-Honk"
- diceware --no-caps
Create a passphrase without capital words. Creates something like "wheel-dye-honk".
- diceware -r realdice
Use real dice to create a passphrase. The programm will tell you what to do (roll dice and tell what numbers appear) and in the end present a passphrase.
- diceware -r realdice --dice-sides 20
Use real dice, as shown above, but this time use dice with 20 faces, instead of standard, 6-sided dice.
- diceware mywordlist.txt
Create a passphrase with words from file "mywordlist.txt". The file should contain one word on each line.
- diceware -w en_orig -s 2
Create a passphrase with two special chars spread over the generated passphrase and containing words from wordlist "en_orig". This is one of the wordlists that come included with diceware. Creates something like: "Rutt[FanScoldLouiseT*nyThrob".
Copyright (C) 2015-2018 Uli Fouquet and contributors
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/>.
diceware is a concept invented by Arnold G. Reinhold, Cambridge, Massachusetts USA.
The English Diceware Wordlists used with this programme are licensed by Arnold G. Reinhold (files wordlists/wordlist_en_orig.asc, wordlists/wordlist_en.txt) under the Creative Commons CC-BY 3.0 license (see http://creativecommons.org/licenses/by/3.0/).
The Securedrop wordlist (file wordlists/wordlist_en_securedrop.asc) by Heartsucker is licensed under the MIT license (see http://mit-license.org/).
The EFF wordlist (file wordlsts/wordlist_en_eff.txt) is licensed by the Electronic Frontier Foundation under the Creative Commons CC-BY 3.0 US license (see https://creativecommons.org/licenses/by/3.0/us/).
"Diceware" is a trademark of Arnold G Reinhold, used with permission.
Written by Uli Fouquet and contributors