Dice

Lookup dice-generated passphrases from EFF's long wordlist.

Dice-generated passphrases are nice, but looking them up from the wordlist can be a bit tedious.

This tiny command-line tool contains a copy of Electronic Frontier Foundation's Long Wordlist and does the lookup for you without your data leaving your computer at any time. Get your dice rolling!

Usage

1. Roll five dice at once, as many times as you wish (typically: six times) and write down the results as described in this Electronic Frontier Foundation's guide.
2. Run dice in you preferred terminal
3. Input the result of the throws of your dice when prompted
4. Copy your passphrase!

# Or just run dice and follow the instructions!
dice

Installation

Binaries for official releases may be downloaded from the releases page on GitHub.

If you want to compile it from source, try:

# clone the repository
git clone git@github.com/gonzalo-bulnes/dice

# compile the code
cd dice
cargo build --release

# place the binary in you $PATH
mv target/release/dice /usr/local/bin/dice \
  && chmod +x /usr/local/bin/dice

For Unix/Linux users, you can install dice using the following command. You may want to change the version number in the command below from v1.0.0-alpha to whichever version you want:

sudo curl -sL -o /usr/local/bin/dice \
  https://github.com/gonzalo-bulnes/dice/releases/download/v1.0.0-alpha/dice-linux-amd64 \
  && sudo chmod +x /usr/local/bin/dice

Contributing

Code review

This is my first Rust program! You're welcome to open a PR to walk me through any refactoring that would help me learn about:

• making the Rust code more idiomatic
• leveraging modules and ownership for better code readability
• building static releases for other platforms
• anything else that you find relevant!

Pull requests

Whether it is your first pull request or your 100th, the contributing guidelines are here to help you get started!

Please note that by participating in this project, you agree to abide by its code of conduct. That is true for pull requests, and also when participating in issues.

Credits

The game die emoji in the header was rendered from an SVG that belongs to Google and was published under the Apache License v2.0 as part of Noto Emoji.

License

Dice
Copyright (C) 2018 Gonzalo Bulnes Guilpain

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/>.