Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/natefinch/diceware
an implementation of the diceware passphrase generation algorithm
https://github.com/natefinch/diceware
Last synced: 10 days ago
JSON representation
an implementation of the diceware passphrase generation algorithm
- Host: GitHub
- URL: https://github.com/natefinch/diceware
- Owner: natefinch
- License: mit
- Created: 2015-06-16T04:44:25.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-10-03T14:19:21.000Z (about 1 month ago)
- Last Synced: 2024-10-12T06:43:53.783Z (27 days ago)
- Language: Go
- Homepage:
- Size: 97.7 KB
- Stars: 22
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Diceware
Diceware generates passphrases using a method that conforms to the algorithm
stated here: http://world.std.com/~reinhold/diceware.html
This program uses Go's cryptographically secure psuedorandom number generator to
generate the "die rolls" for the algorithm.
## What is a passphrase?
A passphrase is a password that is made up of a handful of words. This makes the
password easy to remember and easy to type, even on a phone. Note that the
passphrase needs to be longer than a traditional totally random password,
because the passphrase is made of words not just random garbage.
### Installation
Run `go get github.com/natefinch/diceware`
### Usage
```
Usage:
diceware [options]
Options:
-w number of words to generate (default 6)
-e generate an extra random character
By default, diceware uses the diceware wordlist shown here:
http://world.std.com/~reinhold/diceware.wordlist.asc. You may change this by
specifying at most one of the following flags:
-8 use diceware 8k word list
-b use alternate word list from Alan Beale
-f read word list from newline delimited file
-t read word list from tsv file ('12345 word' style)
```
### Examples
**Generate a 6 word passphrase**
$ diceware
21311 24361 53244 15131 61135 14612
colony embark sd brain thing border
The numbers in the first line represent the virtual die rolls. The words under
them are the resulting passphrase (you would type it in without the spaces).
**Generate a 7 word passphrase with an extra random character**
$ diceware -w 7 -e
33533* 34646 64451 36241 42422 12141 15265
ic+ juggle wrist lease misty ames bruit
The * indicates the position of the randomly added special character (in this
case the '+' character).
**Generate a 6 word passphrase from a tab separated values file**
$ diceware -t words.tsv
459 2750 7998 7956 4454 3528
axial gnu 68th 5i murk jukes
The -t flag expects to be passed a file with tab separated values. The first column should be every possible combination of 5 die rolls (from 11111 to 66666). The second column is the word. If there's a quote in the word, the word must be double quoted, and the quote escaped with another quote (so, *hi "son"* would become *"hi ""son"""*)
**Generate a 6 word passphrase from a newline delimited word list**
$ diceware -f words.txt
459 2750 7998 7956 4454 3528
axial gnu 68th 5i murk jukes
The -f flag expects to be passed a file where every word is on its own line. Diceware then just randomly chooses a number from 0 to num(lines). The numbers printed in the first row are the line number of the words that were chosen.