33 releases

✓ Uses Rust 2018 edition

0.4.1 Mar 19, 2020
0.3.5 Nov 29, 2019
0.3.2 Jul 6, 2019
0.2.8 Feb 26, 2019
0.2.1 May 26, 2018

#5 in Authentication

Download history 67/week @ 2019-12-02 619/week @ 2019-12-09 32/week @ 2019-12-23 1/week @ 2019-12-30 4/week @ 2020-01-06 339/week @ 2020-01-13 174/week @ 2020-01-20 1/week @ 2020-01-27 16/week @ 2020-02-03 36/week @ 2020-02-10 42/week @ 2020-02-17 121/week @ 2020-02-24 1/week @ 2020-03-02 66/week @ 2020-03-09 71/week @ 2020-03-16

294 downloads per month

AGPL-3.0

29KB
470 lines

genpass Build Status Donate

A simple yet robust commandline random password generator.

Multiplatform (Linux, Mac, Windows). Fast.

You can use it generate keys or passwords in scripts or use it as your primary desktop password generator.

Has extensive generative test suite, including tests against a Rust port of Dropbox's password strength tester zxcvbn

Typical usage

genpass                  # use defaults, they're good
genpass 2048             # generate long password, can be used as a key
genpass --passphrase 128 # generate longer passphrase
genpass -dlu             # no special characters

Generating a password directly into your system cliboard

On a Mac:

genpass | pbcopy

On Linux:

genpass | xclip -selection clipboard

Installation

On a system with Rust installed:

$ cargo install genpass

Commandline options

$ genpass --help

USAGE:
    genpass [FLAGS] [length]

FLAGS:
    -h, --help                 Prints help information
    -d, --include-digit        Include at least one digit
    -l, --include-lowercase    Include at least one lowercase letter
    -s, --include-special      Include at least one special (non-alphanumeric) character
    -u, --include-uppercase    Include at least one uppercase letter
        --passphrase           Create a passphrase of (at least) the given length instead of a password.
        --version

ARGS:
    <length>    The length of the password to generate [default: 32]

A note on passphrases

  • Passphrases are generated using EFF's "long" password list.
  • Passphrases are at least --length characters long, not necessarily exactly that long.

A road to 1.0

TODOs to get genpass to 1.0

Contributing

All contributions welcome ! Ideally - start a discussion with an issue first before contributing a PR.

Dependencies

~2.3–4MB
~83K SLoC