1DICEWARE(1)                      User Commands                     DICEWARE(1)
2
3
4

NAME

6       diceware - create passphrases
7

SYNOPSIS

9       diceware [OPTION]... [FILE]
10

DESCRIPTION

12       diceware  generates  passphrases by concatenating words randomly picked
13       from wordlists. It supports also real dice for passphrase generation.
14
15       It  is  based   on   the   proposals   of   Arnold   G.   Reinhold   on
16       http://diceware.com.
17

OPTIONS

19       positional arguments:
20
21          FILE   optional  input  wordlist.  '-'  will read from stdin. Should
22                 contain one word per line.
23
24       optional arguments:
25
26          -h, --help
27                 show help message and exit
28
29          -n NUM, --num NUM
30                 number of words to concatenate. Default 6
31
32          -c, --caps
33                 Capitalize words. This is the default.
34
35          --no-caps
36                 Turn off capitalization.
37
38          -s NUM, --specials NUM
39                 Insert NUM special chars into generated word.
40
41          -d DELIMITER, --delimiter DELIMITER
42                 Separate words by DELIMITER. Empty string by default.
43
44          -r SOURCE, --randomsource SOURCE
45                 Get randomness from this source. Possible  values:  realdice,
46                 system. Default: system
47
48          -w NAME, --wordlist NAME
49                 Use  words  from  this wordlist. Possible values: en, en_eff,
50                 en_orig, en_securedrop.  Wordlists are stored in  the  folder
51                 displayed below.  Default: en_eff
52
53          -v, --verbose
54                 Be verbose. Use several times for increased verbosity.
55
56          --version
57                 output version information and exit.
58
59       Arguments related to realdice randomsource:
60
61          --dice-sides N
62                 Number of sides of dice. Default: 6
63

FILES

65       ~/.diceware.ini
66              Your personal diceware configuration file.
67
68       diceware also comes with a set of wordlists. The path where these lists
69       are stored is showed with --help.
70

EXAMPLES

72       diceware
73              Create a  passphrase  using  defaults.  Outputs  something  like
74              "WheelDyeHonkCanvasWitsPuck"
75
76       diceware -d "-" -n 3
77              Create  a  passphrase with three words, separated by dash ("-").
78              Results in something like "Wheel-Dye-Honk"
79
80       diceware --no-caps
81              Create a passphrase without  capital  words.  Creates  something
82              like "wheel-dye-honk".
83
84       diceware -r realdice
85              Use real dice to create a passphrase. The programm will tell you
86              what to do (roll dice and tell what numbers appear) and  in  the
87              end present a passphrase.
88
89       diceware -r realdice --dice-sides 20
90              Use  real  dice,  as shown above, but this time use dice with 20
91              faces, instead of standard, 6-sided dice.
92
93       diceware mywordlist.txt
94              Create a passphrase with words from file  "mywordlist.txt".  The
95              file should contain one word on each line.
96
97       diceware -w en_orig -s 2
98              Create  a passphrase with two special chars spread over the gen‐
99              erated passphrase and containing words from wordlist  "en_orig".
100              This  is  one of the wordlists that come included with diceware.
101              Creates something like: "Rutt[FanScoldLouiseT*nyThrob".
102

104       Copyright (C) 2015-2018 Uli Fouquet and contributors
105
106       This program is free software: you can redistribute it and/or modify it
107       under  the  terms of the GNU General Public License as published by the
108       Free Software Foundation, either version 3 of the License, or (at  your
109       option) any later version.
110
111       This  program  is  distributed  in the hope that it will be useful, but
112       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
113       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
114       Public License for more details.
115
116       You should have received a copy of the GNU General Public License along
117       with this program.  If not, see <http://www.gnu.org/licenses/>.
118
119       diceware is a concept invented by Arnold G. Reinhold, Cambridge, Massa‐
120       chusetts USA.
121
122       The English Diceware Wordlists used with this programme are licensed by
123       Arnold     G.     Reinhold    (files    wordlists/wordlist_en_orig.asc,
124       wordlists/wordlist_en.txt) under the Creative Commons CC-BY 3.0 license
125       (see http://creativecommons.org/licenses/by/3.0/).
126
127       The  Securedrop wordlist (file wordlists/wordlist_en_securedrop.asc) by
128       Heartsucker    is    licensed    under    the    MIT    license    (see
129       http://mit-license.org/).
130
131       The EFF wordlist (file wordlsts/wordlist_en_eff.txt) is licensed by the
132       Electronic Frontier Foundation under the Creative Commons CC-BY 3.0  US
133       license (see https://creativecommons.org/licenses/by/3.0/us/).
134
135       "Diceware" is a trademark of Arnold G Reinhold, used with permission.
136

AUTHOR

138       Written by Uli Fouquet and contributors
139
140
141
142
143diceware 0.9.5.dev0               April 2018                       DICEWARE(1)
Impressum