https://github.com/tlinden/diceware

A diceware password generator
https://github.com/tlinden/diceware

Last synced: about 1 month ago
JSON representation

A diceware password generator

• Host: GitHub
• URL: https://github.com/tlinden/diceware
• Owner: TLINDEN
• License: gpl-3.0
• Created: 2015-07-31T20:27:14.000Z (almost 11 years ago)
• Default Branch: github
• Last Pushed: 2025-11-05T21:39:59.000Z (8 months ago)
• Last Synced: 2025-11-05T23:31:34.208Z (8 months ago)
• Homepage: http://www.daemon.de/blog/2015/08/03/403/diceware-password-generator/
• Size: 1.71 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![status-badge](https://ci.codeberg.org/api/badges/15537/status.svg)](https://ci.codeberg.org/repos/15537)

[![License](https://img.shields.io/badge/license-GPL-blue.svg)](https://codeberg.org/scip/diceware/raw/branch/master/LICENSE)

[![Documentation](https://img.shields.io/badge/manpage-documentation-blue)](https://codeberg.org/scip/diceware/raw/branch/main/dicepwgen.pod)

> [!IMPORTANT]

> This software is now being maintained on [Codeberg](https://codeberg.org/scip/diceware/).

## dicepwgen - A diceware password generator

`dicepwgen` generates a [diceware password](https://de.wikipedia.org/wiki/Diceware)

using a dictionary file. By default it uses pseudo random dice tosses,

but it is also possible to use real dices and enter the numbers by using

the option `-t`, which is the most secure way to generate diceware passwords.

## Documentation

You can read the documentation without installing the

software:

    perldoc dicepwgen.pod

If it is already installed, you can read the manual page:

    man dicepwgen

## Installation

This software doesn't have any external dependencies, but

you need either BSD make or GNU make installed to build it.

First you need to check out the source code. Skip this, if

you have already done so:

    git clone git@github.com:TLINDEN/diceware.git

Next, change into the newly created directory 'diceware' and

compile the source code:

    cd diceware

    make

Although dicepwgen has an option to specify a dictionary file

on the commandline, there's also a built-in default. This default

can be modified during compilation, e.g.:

    make DICTFILE=/usr/local/share/dict/german.txt

To install, type this command:

    sudo make install

This will install the binary to `$PREFIX/sbin/dicepwgen` and

the manual page to `$PREFIX/man/man1/dicepwgen.1`. You can

modify `$PREFIX` during installation time like this:

   make install PREFIX=/opt

## Usage

    Usage: dice [-tcfvhd]

    Options: 

    -t --humantoss            Asks interactively for rolled dices

    -c --wordcount     Number of words (default: 4)

    -f --dictfile   Dictionary file to use (default:

                              /usr/share/dict/american-english)

    -l --minlen        Minimum word len (default: 5)

    -m --maxlen        Maximum word len (default: 10)

    -n --dontjump             Use all words in the dict file, e.g.

                              if it is an original diceware list   

    -d --debug                Enable debug output

    -v --version              Print program version

    -h -? --help              Print this help screen

If you want to generate a truly random diceware password, use

the option -t. In that case you have to roll physical dices and

enter the results (dicepwgen will ask you for them).

## Getting help

Although I'm happy to hear from dicepwgen users in private email,

that's the best way for me to forget to do something.

In order to report a bug, unexpected behavior, feature requests

or to submit a patch, please open an issue on github:

https://github.com/TLINDEN/diceware/issues.

## License

This software is licensed under the GNU GENERAL PUBLIC LICENSE version 3.

## Author

T.v.Dein 

## Project homepage

https://github.com/TLINDEN/diceware