npwg - Secure Password Generator

npwg is a secure password generator written in Rust. With npwg, you can easily generate strong and random passwords or passphrases to protect your online accounts.

Features

• Generate passwords with custom length
• Support various predefined character sets
• Generate multiple passwords at once
• Generate diceware passphrases
• Avoid repeating characters in passwords
• Display statistics about the generated passwords

Installation

Using Cargo

If you have Rust and Cargo installed, you can install npwg using the following command:

cargo install npwg

This will download and compile the latest version of npwg and install it in your Cargo binary directory.

Manual Installation

1. Make sure you have Rust installed on your system. If not, you can download it from the official Rust website: https://www.rust-lang.org/tools/install
2. Clone this repository:

   git clone https://github.com/vschwaberow/npwg.git

3. Navigate to the project directory:

   cd npwg

4. Build the project:

   cargo build --release

5. The executable can be found at target/release/npwg.

Usage

npwg [OPTIONS]

Options

• -l, --length <LENGTH>: Sets the length of the password (or number of words for passphrases) [default: 16]
• -c, --count <COUNT>: Sets the number of passwords to generate [default: 1]
• --avoid-repeating: Avoid repeating characters in the password
• --stats: Show statistics about the generated passwords
• -a, --allowed <CHARS>: Sets the allowed characters (comma-separated list of predefined sets) [default: allprint]
• --use-words: Use words instead of characters (generate diceware passphrases)
• --separator <SEPARATOR>: Sets the separator for diceware passphrases. Can be a single character or 'random'. Only applicable with --use-words. [default: space]
• -i --interactive: Interactive mode, use a small console based gui to lead through the process
• -h, --help: Print help
• -V, --version: Print version

Predefined Character Sets

• symbol1, symbol2, symbol3: Different sets of symbols
• digit: Numeric digits
• lowerletter: Lowercase letters
• upperletter: Uppercase letters
• shell: Shell-safe characters
• homoglyph1 to homoglyph8: Various homoglyph sets
• slashes, brackets, punctuation: Specific character types
• all, allprint, allprintnoquote, etc.: Various combinations of character types

Examples

Use the interactive mode

npwg -i

or

npwg --interactive

Generate a password with the default length (16 characters):

npwg

Generate a password with a specific length:

npwg -l 12

Generate multiple passwords:

npwg -c 5

Generate a password using only uppercase and lowercase letters:

npwg -a upperletter,lowerletter

Generate a diceware passphrase:

npwg --use-words -l 6

Generate a password and display statistics:

npwg --stats

Generate a password using the Diceware method. If no diceware wordlist is in ~/.npwg, it will be automatically downloaded from the EFF website:

npwg -d

Generate a password using the Diceware method with a custom number of words. The default number of words is 6. The wordlist will be downloaded if it is not found in ~/.npwg:

npwg -d -w 8

Generate a diceware passphrase with a custom separator:

npwg --use-words --separator "-" -l 6

Generate a diceware passphrase with random separators:

npwg --use-words --separator random -l 6

Contributing

Contributions are welcome! If you find a bug or have a suggestion for improvement, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.