Pronounceable Password Generator is a node.js script that generates strings of characters in the command line that are ordered in a way that is pronounceable and possibly easier to remember if you wish to memorize them.
It could also be used for creating random usernames or for anything where you might want a unique pronounceable string.
This script has been converted to TypeScript and is compiled to ESNext JavaScript with Babel. The script to run with node.js is under the ./dist directory.
- Installation
- Quick Start
- Advanced Usage
- Usage Examples
- Customization
- Build Binaries from Source
- Included Modules
- License
The latest releases have been packaged as standalone binaries for MacOS, Linux, and Windows.
- Download the latest release zip file for your operating system.
- Unzip the file where you would like to keep it.
- Use your terminal to enter the propass directory.
On MacOS and Linux, you may need to chmod +x propass to make it executable. If you will be using propass often, you might wish to place it in your PATH.
Note: node.js should already be installed on your system.
git clone https://github.com:josh-clarke/propass.git
cd propass
npm install
To run
propassas a node.js script, you must typenode ./dist/propass.jsto execute it. In a Bash/ZSH shell you should also be able tochmod +x ./dist/propass.jsand then execute./dist/propass.jsdirectly.
Calling the propass binary on its own generates three password options with the default settings.
./propass
The full default settings are:
- 3 password options
- 13 character length
- 1 symbol
- 2 numbers
- lowercase letters will fill out the remaining length
You can view all the options and some examples with the --help flag.
./propass --help
When you have chosen your password, I recommend executing the
clearcommand to wipe the password options from the terminal display. Note: This will also wipe any other output from the the terminal that you have entered this session.
You can set how many password options you get with the --passwords or -p flag. The example will list 25 passwords.
./propass --passwords 25
The length of the password options can be changed with the --length or -l flag. The example will list passwords that are 20 characters long.
./propass --length 20
One source suggests that a good password is at least 12 characters. Another suggests that a 16 character all lowercase password would take 208 billion minutes to crack with today's computers.
The amount of numbers or symbols in a password can be set with --numbers or -n and -symbols or -s, respectively. Keep in mind that these options do not change the total length of the password, so additional numbers and symbols will reduce the number of letters in the password unless you lengthen the password.
The example creates passwords that include 3 numbers and 3 symbols. The length has also been set to 16 total characters.
./propass --symbols 3 --numbers 3 --length 16
If you need capitals, you can call the --caps or -c flag. This will capitalize the first consonants of a syllable, which typically results in 3 capitals for passwords using the default settings.
./propass --caps
If you want the numbers and symbols randomly mixed into the password, you can call the --mix or -m flag. This may reduce pronounceability.
./propass --mix
These examples all use the short flags, which are easier to type. You can view these examples using the --help flag.
propass # Generates 3 password options
with the default settings
propass -l 18 # Generates 3 password options
that are 18 characters long
propass -p 10 -s 2 -n 3 -c # Generates 10 password options
with 2 symbols, 3 numbers, and
capitals mixed with lowercase
propass -p 5 -mc # Generates 5 password options
with capital letters and the
numbers and symbols mixed in
The generator relies on a JSON file called syllables.json which can be modified to add or remove consonants, vowels, numbers, and symbols.
The letters are weighted. Essentially the script rolls a d20 to determine whether the randomly selected letter is used. If not, it randomly picks a new letter and tries again. The letters are roughly weighted by their use in English, with weight ratings from 1 to 20. A low number means the letter will be selected more often and a high number means it will be selected less often.
The --unweighted or -w flag can be used to ignore the letter weights.
Note: The binary version of this script bundles
syllables.jsoninto itself. If you want to modify thesyllables.json, you cangit cloneand hack the code, and then build the binaries from source.
- Clone the repository.
git clone https://github.com:josh-clarke/propass.git
- Enter the directory and install the node module dependencies.
cd propass
npm install
-
Enter the
./srcdirectory and make any changes that you want to thepropass.tsfile orsyllables.jsonfile. If you would like to, you could take a look at the DEVNOTES file. -
Install the node.js module
pkgif you do not already have it. It is used to build the binaries.
npm install -g pkg
-
Run
npm run compileto compile the TypeScript source into ESNext JavaScript. -
Run
npm run buildin a MacOS or Linux terminal, or in a WSL terminal on Windows.
By default the build script will build binaries for MacOS, Linux, and Windows and bundle them in a .zip archive with the README and LICENSE files. They will appear in a folder called ./build. The build.sh script should be easy to figure out and modify to suit your needs.
This script makes use of the random-seed module, which is a node.js port of the Gibson Research Corporation's Ultra-High Entropy Pseudo-Random Number Generator.
It also uses the Yargs module for beautiful handling of command line arguments.
This script is licensed under the MIT License.