genpw, in Javascript (under a different name)
b840c538 — dependabot[bot] 6 months ago
build(deps): bump lodash from 4.17.15 to 4.17.20 (#11)
31d6fb97 — dependabot[bot] 6 months ago
build(deps-dev): bump standard-version from 8.0.0 to 8.0.1 (#12)
0d429b3e — Mark Cornick 6 months ago
fix(Math): Math.floor instead of parseInt



You can also use your local clone with git send-email.

#Maintenance Mode

passwoid is feature-complete and no longer under active development.


Build Status Build Status Coverage Status Commitizen friendly

A reasonably secure password generator

passwoid generates reasonably secure passwords. That's it; that's all it does.

The passwords generated by passwoid are strings of random characters. Passwords are chosen from the set of all upper-case letters except I and O, all lower-case letters except l, and the digits 2 through 9. 0 and O are not used to avoid confusion with each other when passwords are displayed in sans-serif fonts. I, l, and 1 are not used for the same reason. Passwords are guaranteed to contain at least one upper-case letter, one lower-case letter, and one number.

The default length is 16. The minimum length is 3, because a shorter password would not satisfy the requirement to use all three classes of characters. passwoid will create a password of any length of 3 or greater, and guarantees that passwords will not repeat any characters if the requested length is 57 or less.


# for programmatic usage
npm install --save passwoid
# for command-line usage
npm install --global passwoid
# or use npx (see below)

#Programmatic Usage

var passwoid = require("passwoid");

passwoid(); // returns a password of the default length (16)
passwoid(8); // returns a password of length 8
passwoid(1); // throws Error: Cannot generate password of length 1

#Command-Line Usage With Global Install

$ passwoid
$ passwoid 8
$ passwoid 1
    throw new Error('Cannot generate password of length ' + length);
Error: Cannot generate password of length 1

#Command-Line Usage With npx

$ npx -q passwoid
$ npx -q passwoid 8
$ npx -q passwoid 1
Cannot generate password of length 1


Bug reports and pull requests are welcome on GitHub at https://github.com/markcornick/passwoid. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


passwoid is available as open source under the terms of the Apache License version 2.0.