CrunchX is a fast and flexible tool for generating custom wordlists with powerful features for penetration testers, CTF players, and security enthusiasts.
./crunchX <min> <max> <charset/options><min>: Minimum password length<max>: Maximum password length<charset/options>: Define characters, patterns, filters, and more
| Flag | Description |
|---|---|
-b <size> |
Maximum number of bytes to write to the output file (e.g. -b 1000000) |
-c <number>, --count <number> |
Limit the total number of passwords generated |
-t <pattern> |
Generate based on a pattern (e.g. @%@ → lowercase, digit, lowercase)Pattern symbols: @ = lowercase, , = uppercase, % = digits, ^ = symbols |
-l <chars> |
Define literal characters for use with @, ,, %, ^ (e.g. -l az09) |
-d <n>[@,%^] |
Prevent more than n adjacent duplicate characters of the specified type |
-e <string> |
Stop generation when this exact password is reached |
-f <file> <name> |
Load charset from file by name (e.g. charsets.txt with lower=abcd) |
-i |
Invert generation order (currently placeholder only) |
-o <file>, --output <file> |
Output file path |
-p |
Generate all permutations without repeating characters |
-q <file> |
Load strings from file for permutation generation |
-r, --resume-file <file> |
Resume from the last password in the previous output |
-s <string> |
Start generating from a specific password |
-u |
Disable progress percentage display |
-z <type>, --zip <type> |
Compress output (gzip, bzip2, lzma, 7z) |
| Flag | Description |
|---|---|
--target-info <info> |
Generate passwords based on target-specific data (name, DOB, etc.) |
--dict <file> |
Use a dictionary wordlist |
--suffix <pattern> |
Add suffixes to dictionary words |
--add-after <text> |
Add prefix to password |
--add-before <text> |
aff suffix to password |
--filter |
Filter passwords based on complexity (weak/medium/strong) |
--estimate |
Estimate size of the generated output |
--split <size> |
Split output into multiple files of given size |
- git clone https://github.com/amirroox/crunchX
- cd crunchX
- build main.cpp
g++ main.cpp -o main # linux
g++ main.cpp -o main.exe # windowsOR
Download Release :)
- Simplest usage – Generate a list of passwords from 1 to 5 characters using all lowercase letters and digits:
crunchx.exe 1 5 # Windows
./crunchx 1 5 # Linux- Custom character set:
crunchx.exe 1 5 "ABC123xyz" # Windows
./crunchx 1 5 "ABC123xyz" # Linux- Output passwords to a file:
crunchx.exe 1 5 "ABC123xyz" -o pass.txt # Windows
./crunchx 1 5 "ABC123xyz" --output pass.txt # Linux- Limit the number of generated passwords:
crunchx.exe 1 5 -c 5000 # Windows
./crunchx 1 5 --count 5000 # Linux- Limit output file size – use
kfor kilobytes,mfor megabytes, andgfor gigabytes:
crunchx.exe 1 5 -o test.txt -b 1048576 # Windows
./crunchx 1 5 -o test.txt -b "1m" # Linux- Pattern-based password generation –
@= lowercase,,= uppercase,%= digit,^= symbol. Use-lwith a fixed-length set of characters to customize allowed characters:
crunchx.exe 5 5 -l abcdefg1234 -t "@@@%%" # Windows
./crunchx 5 5 -l abcdefg1234 -t "@@@%%" # Linux- Limit the number of specific character types –
@= lowercase,,= uppercase,%= digit,^= symbol (not fully implemented yet ×):
crunchx.exe 1 5 -d "2@" # Windows
./crunchx 1 5 -d "2@" # Linux- Stop generation after reaching a specific keyword:
crunchx.exe 1 4 abcdefghijklm -e "jjjj" # Windows
./crunchx 1 4 abcdefghijklm -e "jjjj" # Linux- Load custom characters from a file:
crunchx.exe 1 5 -f file.txt -o test.txt # Windows
./crunchx 1 5 -f file.txt -o test.txt # Linux- Generate passwords in reverse order:
crunchx.exe 1 5 -i -o pass.txt # Windows
./crunchx 1 5 -i -o pass.txt # Linux- Generate passwords without character repetition:
crunchx.exe 1 5 -p -o file.txt # Windows
./crunchx 1 5 -p -o file.txt # Linux- Read strings from a file (incomplete ×):
crunchx.exe 1 5 -p -o file.txt -q f.txt # Windows
./crunchx 1 5 -p -o file.txt -q f.txt # Linux- Resume password generation from an output file:
crunchx.exe 1 5 -r last_file.txt -o file.txt # Windows
./crunchx 1 5 --resume-file last_file.txt -o file.txt # Linux- Start generation from a specific string:
crunchx.exe 1 5 abcdefg -e "eeee" # Windows
./crunchx 1 5 abcdefg -e "eeee" # Linux- Disable progress percentage display – works only when
-cflag is used:
crunchx.exe 1 12 abcdefghij -c 10000000 -u # Windows
./crunchx 1 12 abcdefghij -c 10000000 -u # Linux- Compress output file – Requires proper tools installed (
gzip,bzip2,lzma,7z). Output file must be specified:
crunchx.exe 1 5 -o file.txt --zip # Windows
./crunchx 1 5 -o file.txt --zip gzip # Linux- Generate variations of your target list – use
+at the end to include all case variations and permutations:
crunchx.exe --target-info "dani 2002 roox" -o target.txt # Windows
./crunchx --target-info "dani 2002 roox+" -o target.txt # Linux- Generate random passwords from a dictionary file –
--dictand--suffixwork together (not fully functional ×):
crunchx.exe --dict .\t.txt --suffix "{num}{sym}" -o jj.txt # Windows
./crunchx --dict .\t.txt --suffix "{num}{sym}" -o jj.txt # Linux- Add a specific word after each password:
crunchx.exe 1 3 --add-after "amir" # Windows
./crunchx 1 3 --add-after "amir" # Linux- Add a specific word before each password:
crunchx.exe 1 3 --add-before "dani" # Windows
./crunchx 1 3 --add-before "dani" # Linux- Display strength of generated passwords:
crunchx.exe 1 5 --filter # Windows
./crunchx 1 5 --filter # Linux- Estimate output size:
crunchx.exe 1 5 --estimate # Windows
./crunchx 1 5 --estimate # Linux- Split large output files into parts – Output must be specified:
crunchx.exe 1 4 -o jj.txt --split "1m" # Windows
./crunchx 1 4 -o jj.txt --split "1m" # LinuxExample charsets.txt:
lower=abcd
upper=ABCD
digits=0123
- To limit resource usage, always use
-c,-b, or--count - For large outputs, combine
--splitand--zipfor manageability
Created by AmirRoox — crafted for speed, flexibility, and real-world use in security and automation tasks.
Feel free to fork and open PRs. Suggestions and improvements are welcome!
All documented flags are implemented and functional.
Generate smarter. Generate stronger. 🔐