CharVomit

module
v1.6.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 4, 2026 License: MIT

README

CharVomit

Go Coverage

Generate random passwords using Go's crypto/rand functions.

The passwords should look like the cat puked up random characters, hence the name.

Usage

Usage: CharVomit [ length ]

If a password length is not specified, 32 is used.

Other optional flags are:
  -d	use numeric digits
  -h	show help and exit
  -l	use lower-case letters
  -s	use symbols: !#%+:=?@
  -u	use upper-case letters
  -v	show version
  -w	use weak characters (2-9, A-N, P-Z, a-k, m-z)
  -x string
    	excluded characters (will be removed)

Note that optional flags must precede the password length.

For example, a 8-character password of all capital letters:
CharVomit -u 8

Also note that certain characters that are confusing are ignored by default,
such as '0', 'O', '1', and 'l'. You can still get those characters, if you wish,
by using the -u, -l, and -d flags. The default is equivalent to -w -s.

Examples

32-character password, without ambiguous characters
$ CharVomit
Va9nBzgtW:Xt@28pcXW+6zpjb@DuyqJ3
20-character password, with weak (non-ambiguous) characters, no symbols
$ CharVomit -w 20
qm995CZrA7pRC4SgfDrJ
16-character password, with all upper- and lower-case letters and digits, as well as the symbols '!' and '@'
$ CharVomit -l -u -s -x '#%+:=?' 20
Xl!bXDnZC@srbxBDNzdj

To-Do

  • Implement functionality to specify number of duplicate characters
  • Improve documentation

Installation

If you have a Go compiler installed, you can use this command:

go install -v github.com/mojotx/CharVomit/cmd/CharVomit@latest

Alternatively, you can download the latest release.

Directories

Path Synopsis
cmd
CharVomit command
pkg
CharVomit
Package CharVomit provides functionality to generate large pseudo-random passwords, that look as if a cat puked up random characters.
Package CharVomit provides functionality to generate large pseudo-random passwords, that look as if a cat puked up random characters.
arg
Package arg is a helper package for parsing command-line arguments.
Package arg is a helper package for parsing command-line arguments.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL