pwgenie

README

PwGenie

A simple password generator written in Golang.

Table of content:

• 1. Introduction
• 2. Installation
• 3. Usage
• 4. Contributing

1. Introduction

PwGenie is a command-line application written in Golang to generate secure passwords.

It's highly inspired by Motus and go-password.

Features:

• Generate secure human-friendly memorable passwords using EFF's wordlist.
• Generate random passwords with optional (uppercase, number, symbol inclusion), follow the algorithm described in AgileBits 1Password.
• Generate PINs with customizable length.
• Enable/disable repeat.
• Clipboard integration for easy password usage (Default).

2. Installation

3. Usage

$ pwgenie

pwgenie is a simple password generator.
<https://github.com/ntk148v/pwgenie>

Usage
-----

  pwgenie [OPTIONS] <SUBCOMMAND> [SUBCOMMAND-OPTIONS]

Options
-------

  -allow-repeat
                Allow repeat characters in the generated password

  -no-clipboard
                Disable automatic copying of generated password to clipboard

Subcommands
-----------

  human    Generate a human-friendly memorable password
  random   Generate a random password with specified complexity
  pin      Generate a random numeric PIN code

Run subcommand with '-h' for subcommand's options.

Example
-------

  $ pwgenie human
  trade clash striking underdog arbitrate

  $ pwgenie human -sep -
  preplan-mousiness-joining-eskimo-linguist

  $ pwgenie random
  bwuelvko

  $ pwgenie random -symb -num -upper
  _U*HkTzA

• Generate a human-friendly memorable password

$ pwgenie human -h

Generate a human-friendly memorable password

Usage of 'pwgenie human':
  -cap
        Enable capitalization of each word in the generated password
  -sep string
        The separator for words in the generated password (default " ")
  -words int
        The number of words in the generated password (default 5)

$ pwgenie human -sep - -words 10
stray-tableful-equity-stylishly-playmaker-pagan-upturned-gizzard-huntsman-defile

$ pwgenie human -cap
Daredevil Malt Recycler Prior Mutual

• Generate a random password

$ pwgenie random -h
Generate a random password with specified complexity

Usage of 'pwgenie random':
  -digit
        Enable the inclusion of numbers in the generated password
  -length int
        The number of characters in the generated password (default 8)
  -symbol
        Enable the inclusion of symbols in the generated password
  -upper
        Enable the inclusion of upper-case letters in the generated passwords

$ pwgenie random -digit -symbol -upper
iJdNmD0*

$ pwgenie random -digit -symbol -upper -length 20
LohapCbF_vzyuItDX91Z

• Generate a PIN

$ pwgenie pin -h
Generate a random numeric PIN code

Usage of 'pwgenie pin':
  -length int
        The number of digits in the generated PIN code (default 6)

$ pwgenie pin
491768

4. Contributing

We welcome contributions to the project. Feel free to submit issues, suggest new features, or create pull requests to help improve pwgenie.

Documentation

Overview

pwgenie is a simple package generator