wrdlist

A simple and efficient tool for generating custom word lists. Ideal for creating test data, pattern-based combinations, and structured text sequences.

Features

• Quickly generate custom word lists with simple commands.
• Easy-to-understand pattern syntax for flexible generation.
• View results in the terminal or save them to a file.
• Handle large outputs efficiently with file size warnings.
• Randomize or reverse the order of results.

Installation

Install Required Tools

Before installing wrdlist, you need to install the necessary tools depending on your distribution.

Arch Linux:

sudo pacman -S rust

Debian/Ubuntu:

sudo apt install rustc cargo

Fedora:

sudo dnf install rust

Install wrdlist Using Cargo

After installing the required tools, you can install wrdlist using the cargo tool (Rust's package manager):

cargo install wrdlist

To make sure wrdlist is globally accessible, you can copy it to /usr/bin and make it executable:

sudo cp ~/.cargo/bin/wrdlist /usr/bin
sudo chmod +x /usr/bin/wrdlist

Install from AUR (Arch Linux)

You can install wrdlist directly from the AUR using an AUR helper like yay:

yay -S wrdlist

Build and Install wrdlist Manually

If you want to build wrdlist from source, follow these steps:

git clone https://github.com/username/wrdlist.git
cd wrdlist
make install

To uninstall:

make uninstall

Usage

wrdlist [OPTIONS] <PATTERN> [OPTIONAL]

Arguments:

• <PATTERN>
  The pattern to generate the wordlist (must be enclosed in double quotes).

Options:

• -r, --random
  Randomize the order of the wordlist.

• -i, --inverse
  Reverse the order of the wordlist.

• -h, --help
  Print help information.

• -v, --version
  Print version information.

Pattern Syntax:

• . with a character to keep it fixed in every word (.a means 'a' stays in place).
• [start-end] for numeric ranges ([1-3] will generate 1, 2, 3).
• ! for any lowercase letter (a-z).
• @ for any uppercase letter (A-Z).
• # for any digit (0-9).
• % for any symbol (!@#$%^&*?).

Optional:

• -o, --output <OUTPUT>
  Save the wordlist to a file.

Example Usage

# Generate a list of lowercase letters followed by digits
wrdlist "#.!"

# Randomize the order of a word list
wrdlist -r "[9-13]"

# Generate a list of numbers from 1 to 3, reversed
wrdlist -i ".#[1-5]._.X.d"

...more in wrdlist --help 

Note: Patterns must be enclosed in double quotes. For complex patterns, check how the output will look before continuing.

Performance

This tool is designed to be lightweight and efficient. It calculates the expected file size before generating large word lists to avoid storage issues. You'll receive a warning if the output is too large, allowing you to decide whether to continue or cancel.