Home

Awesome

crank

Software License GoDoc Build Status Coverage Report

A simple password generation cli app. This app was originally built as a playground for some ideas.

It can generate passwords in multiple formats:

randomtrigraphxkcd
Z#EZssS6Skyh%xQhP@datwyWrationatcfind factory bean waste
w#M27Rpx2G7KI50Oc1yCluh5ishovenfidepth team thumb positive
ta5$WoeqdmEyIWgLGL%UwB5dpedistansexcellent chicken glass ability
kQ3j$lfIwSiP3Ks5lSVML%Y$litinglenstairs live thing die
Qr%A7UHdIddMR9K5QskRmypTnizzinamadraw yard fifty soap

Installing

Compile

This project requires go1.17+ to compile. Just run go install github.com/gesquive/crank@latest and the executable should be built for you automatically in your $GOPATH.

Optionally you can run make install to build and copy the executable to /usr/local/bin/ with correct permissions.

Download

Alternately, you can download the latest release for your platform from github.

Once you have an executable, make sure to copy it somewhere on your path like /usr/local/bin or C:/Program Files/. If on a *nix/mac system, make sure to run chmod +x /path/to/crank.

Homebrew

This app is also avalable from this homebrew tap. Just install the tap and then the app will be available.

$ brew tap gesquive/tap
$ brew install crank

Usage

Generate secure random passwords in a number of different formats

Usage:
  crank [flags] [command]

Available Commands:
  random      Generate random passwords
  trigraph    Generate human readable trigraph passwords
  xkcd        Generate passwords with the XKCD password scheme

Flags:
  -c, --config string   config file (default is $HOME/.config/crank.yml)
  -n, --number value    The number of passwords to generate (default 5)
  -v, --version         Show the version and exit

Use "crank [command] --help" for more information about a command.

Shell Completion

If you install via homebrew, the shell completion scripts are installed for you. Otherwise, this application can generate its own shell completion scripts for bash/fish/zsh.

Bash

To generate and load completion scripts for bash

source <(crank completion bash)

To load completions for each session, execute once:

Linux:

crank completion bash > /etc/bash_completion.d/crank

macOS:

crank completion bash > $(brew --prefix)/etc/bash_completion.d/crank

zsh

If shell completion is not already enabled in your environment, you will need to enable it. You can execute the following once:

echo "autoload -U compinit; compinit" >> ~/.zshrc

To load completions for each session, execute once:

crank completion zsh > "${fpath[1]}/_crank"

You will need to start a new shell for this setup to take effect.

fish

crank completion fish | source

To load completions for each session, execute once:

crank completion fish > ~/.config/fish/completions/crank.fish

Documentation

This documentation can be found at github.com/gesquive/crank

License

This package is made available under an MIT-style license. See LICENSE.

Credits

Trigraph generation code was largely based on the work of multicians. Their excellent gpw app source code can be found at http://www.multicians.org/thvv/tvvtools.html

The XKCD password scheme originated here: http://xkcd.com/936/

Contributing

PRs are always welcome!