You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Go to file
Release Bot b11fcecbd9
ci/woodpecker/push/publish Pipeline failed Details
ci/woodpecker/push/sync Pipeline was successful Details
chore: Release genpass version 0.5.27
5 months ago
.github Update FUNDING.yml 4 years ago
.woodpecker Update '.woodpecker/publish.yml' 5 months ago
scripts extract script to set up ci env 5 months ago
src migrate to crane 5 months ago
tests Add commandline tests 3 years ago
.envrc Update dependencies 2 years ago
.gitignore ignore nix build results 5 months ago
.gitlab-ci.yml port to newer rust 3 years ago
CHANGELOG.md chore: Release genpass version 0.5.27 5 months ago
Cargo.lock chore: Release genpass version 0.5.27 5 months ago
Cargo.toml chore: Release genpass version 0.5.27 5 months ago
LICENSE Initial commit 5 years ago
README.md remove sourcehut build badge 5 months ago
build.rs port to newer rust 3 years ago
flake.lock migrate to crane 5 months ago
flake.nix use develop to run cargo as shell does not have the dev env 5 months ago
release.toml don't use cargo release to push as it's broken 1 year ago
rust-toolchain Move to moz overlay 3 years ago

README.md

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> </head>

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](https://crates.io/crates/zxcvbn) of Dropboxs password strength tester [zxcvbn](https://www.usenix.org/conference/usenixsecurity16/technical-sessions/presentation/wheeler)

## Typical usage ``` genpass # use defaults, theyre 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 clipboard

On a Mac: ``` genpass | pbcopy ``` On Linux: ``` genpass | xclip -selection clipboard ```

## Getting genpass

# If youre using Nix flakes * you can try genpass without installing it nix run git+https://git.cyplo.dev/cyplo/genpass.git * flake url is https://git.cyplo.dev/cyplo/genpass.git

# On any system with Rust installed

``` $ cargo install genpass ```

## Commandline options ``` $ genpass --help

USAGE: genpass [FLAGS] [length]

FLAGS: -h, --help Prints help information -l, --include-lowercase Generate the password using lowercase letters -n, --include-numeric Generate the password using numeric characters -s, --include-special Generate the password using special (non-alphanumeric) characters -u, --include-uppercase Generate the password using uppercase letters --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 [EFFs](https://www.eff.org/deeplinks/2016/07/new-wordlists-random-passphrases) "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 !

# Sources

git clone https://git.cyplo.dev/cyplo/genpass.git

# quickstart

  • you can use [Nix](https://nixos.org/download.html) to recreate the development environment reproducibly

  • nix develop in this repo will give you a shell with all the dependencies needed


</html>