pwgen2 0.8.2

password generator
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

[![Test & Build](https://github.com/nbari/pwgen2/actions/workflows/build.yml/badge.svg)](https://github.com/nbari/pwgen2/actions/workflows/build.yml)
[![codecov](https://codecov.io/gh/nbari/pwgen2/graph/badge.svg?token=IUHSFDK6XD)](https://codecov.io/gh/nbari/pwgen2)

# pwgen2


password generator

Default length is 18 characters, but can be changed with the first argument.

```bash
pwgen2 24
```

Password is generated using the following characters:

```
lowercase: "abcdefghijklmnopqrstuvwxyz",
uppercase: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
digits: "0123456789",
symbols: "!@#$%&.-_*",
```

Generated passwords keep symbols sparse and never start with a symbol.

## Installation

```bash
cargo install pwgen2
```

## Usage

```text
Usage: pwgen2 [OPTIONS] [length] [number]

Arguments:
  [length]
          password length
          
          [default: 18]

  [number]
          Number of passwords to generate
          
          [default: 1]

Options:
  -p, --pin
          Generate a pin

  -a, --alphanumeric
          Generate an alphanumeric password

  -m, --mnemonic [<words>]
          Generate a standard English BIP-39 mnemonic phrase. Omitting the count defaults to 12 words.

  -b, --bcrypt
          Hash the generated password using Bcrypt

  -k, --pbkdf2
          Hash the generated password using PBKDF2

  -s, --sha512
          Hash the generated password using SHA512

  -c, --charset <symbols>
          Symbols to use for password generation. Passwords keep symbols sparse and never start with a symbol.

  -j, --json
          Output as JSON

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Notes:
  Generated passwords keep symbols sparse and never start with a symbol.
  --mnemonic generates a standard English BIP-39 recovery phrase.
```

## Examples

Create a password with 24 characters:

```bash
pwgen2 24
```

Create a pin:

```bash
pwgen2 -p
```

Create an alphanumeric password:

```bash
pwgen2 -a
```

Create 5 passwords with 24 characters:

```bash
pwgen2 24 5
```

Create a password and hash it using Bcrypt:

```bash
pwgen2 -b
```
> useful for generating passwords for htpasswd

Create passwords as JSON:

```bash
pwgen2 -j 18 3
```

Create passwords with a custom symbol set:

```bash
pwgen2 -c '~€' 20 3
```

Create a default 12-word BIP-39 recovery phrase:

```bash
pwgen2 -m
```

Create a 24-word BIP-39 recovery phrase:

```bash
pwgen2 -m 24
```

Create a mnemonic as JSON:

```bash
pwgen2 -m -j
```

Mnemonic mode is mutually exclusive with password generation, custom symbol sets, and hash options.