passgen/README.md

44 lines
1.4 KiB
Markdown

# passgen
passgen generate passphrases based on wordlists.
Usage:
```
Usage: passgen [options]
Options:
-h, --help Display this help message and exit
-s, --short Use the short EFF wordlist
-l, --large Use the large EFF wordlist (dfault)
--camelcase, -cc Generate passphrase in CamelCase format
-p <path>, --path <path>
Use a custom wordlist file located at <path>
-wc <count>, --wordcount <count>
Amount of words to use for passphrase
--separator <seperator> Specify a character to use as a separator between words, default = `-`
Description:
Generate passphrases based on wordlists.
```
example output:
```
retrace-choice-litter-dreamt-zipping
```
This project uses the [EFF's Wordlists for Random Passphrases](https://www.eff.org/deeplinks/2016/07/new-wordlists-random-passphrases) and [PCG random](https://www.pcg-random.org/) to pick random words
Compiling:
Compile to linux:
```
mkdir build-linux && cd build-linux && cmake .. && make
```
Compile to Windows:
```
mkdir build-windows && cd build-windows && cmake -DCMAKE_TOOLCHAIN_FILE=../mingw-toolchain.cmake .. && make
```
Wordlists:
- https://www.eff.org/files/2016/07/18/eff_large_wordlist.txt
- https://www.eff.org/files/2016/09/08/eff_short_wordlist_1.txt
- https://mko.re/diceware/diceware-wordlist-8k-composites-nl.txt