fuse-generator 7.0.0

Generate wordlists using pattern logic and expressions.

Generate wordlists using pattern logic and expressions

Installation    •    Documentation    •    Usage    •    Contributing

Installation

[!NOTE] It is recommended to install using pipx or pip for the PyPI version.

Method	Notes
pipx install fuse-generator	pip may be used in place of pipx
git clone https://github.com/pwnfo/fuse.git && cd fuse && pip install .	Clone and install directly from GitHub

Documentation

For a complete guide, feature explanations, and advanced examples, please visit the documentation.

General usage

To generate a wordlist from a simple expression:

fuse '/l{2,4}'

To combine files with generators:

fuse '^:^' names.txt pass.txt

Outputs can be manipulated, filtered, and saved.

General Options:
  -h, --help            show this help message and exit
  -v, --version         show version information and exit
  -S, --stats           show pattern statistics and exit
  -q, --quiet           suppress non-essential output
  -n, --non-interactive
                        skip the confirmation prompt before execution

Generation Options:
  -d, --delimiter <string>
                        string inserted between generated entries
  -b, --write-buffer <size>
                        output buffer size
  -w, --workers <1-64>  number of worker processes (default: 1)
  -k, --flush-threshold <size>
                        flush output after reaching this byte threshold (default: 512KB)

Input Options:
  -f, --file <path>     load patterns from file
  -s, --start <word>    start writing output from <word>
  -e, --end <word>      stop writing output at <word>

Output Options:
  -o, --output <path>   write output to a file
  -z, --compress <format>
                        compress output (supported: gzip, bzip2, lzma)
  -l, --compresslevel <level>
                        compression level for the selected format

Expression basics

• Literal characters produce themselves.
• Built-in classes and bracketed classes [...] produce one item per position.
• Concatenation combines positions: each position picks one value from its token and concatenates.

Example:

$ fuse '/l{2,3}'
# output: aa, ab, ac, ..., ZY, ZZ

Character classes

Symbol	Meaning
/l	letters (a–z, A–Z)
/a	lowercase letters (a–z)
/A	uppercase letters (A–Z)
/d	digits (0–9)
/D	non-zero digits (1–9)
/h	lowercase hexadecimal (0–9, a–f)
/H	uppercase hexadecimal (0–9, A–F)
/s	space
/o	octal digits (0–7)
/p	special characters
/b	newline (\n)

Example: /l/l generates all two-letter combinations (upper and lower case).

Custom classes and unions

• [abc] selects one character from a, b, or c.
• Use | to separate full-word alternatives inside classes:
  • [admin|root|123] inserts admin OR root OR 123 at that point.
• Use || to separate top-level expressions:
  • fuse 'admin/d||guest/d' chains two independent patterns.

Statistics

You can analyze a pattern before generating it using the -S/--stats flag. This shows token counts, estimated size, and range filtering details.

fuse -S '/l{3}||/d{3}'

Quantifiers

• {N} — repeat exactly N times
• {min,max} — repeat between min and max times (inclusive)
• ? — optional (0 or 1 time)

Examples:

$ fuse '[XYZ]{3}'         # XXX, XXY, ..., ZZZ
$ fuse '[XYZ]{2,5}'       # XY, XZ, ..., XYZXY
$ fuse 'Ryan?/d'          # Rya0, Rya1, ..., Ryan9
$ fuse '[XYZ]?Ryan'       # Ryan, XRyan, YRyan, ZRyan

Numeric ranges

• #[1-10] → generates 1,2,3,4,5,6,7,8,9,10
• #[1-10:2] → generates 1,3,5,7,9
• #[2-10:2] → generates 2,4,6,8,10

These numeric ranges can be used in any position of an expression.

Files and placeholders

Use ^ in an expression as a placeholder for the next file argument. Each ^ consumes one file and iterates over its lines:

$ fuse '^/d' names.txt
# output: Bob0, Bob1, ..., Ana0, Ana1, ...

$ fuse '^-^' names.txt years.txt
# output: Bob-1990, Ana-1991, Ryan-1992, ...

Prefix a filename with // to treat it as an inline expression instead of a file path.

Value bindings

Use <@name=expr> to evaluate an expression once per output line and store it, then reuse it with <@name>. Unlike concatenation, this introduces a dependency, so no cartesian product is created between the definition and its references.

$ fuse '<@d=/d>-<@d>'
# output: 0-0, 1-1, ..., 9-9

$ fuse '<@x=^>:<@x>' words.txt
# output: foo:foo, bar:bar, ...

$ fuse '<@n=/d{2}>_<@n>'
# output: 00_00, 01_01, ..., 99_99

Compression

Fuse supports on-the-fly compression when writing output files.

# gzip (fast, balanced)
fuse '/l{5}' -z gzip -o wordlist.txt.gz

# lzma (best compression)
fuse '/l{5}' -z lzma -o wordlist.txt.xz

# bzip2 (middle ground)
fuse '/l{5}' -z bzip2 -o wordlist.txt.bz2

Escaping special characters

Use \ to escape special characters.

$ fuse '\/d/d'
# output: /d/0, /d/1, ..., /d/9

Contributing

We welcome contributions to Fuse! Whether it's adding new features, improving documentation, or fixing bugs, your help is appreciated. Feel free to open an issue or submit a pull request on our GitHub repository at pwnfo/fuse.

Star History

License

MIT © Ryan R. <[e-mail]>