Password Attackspasswordgeneratorprincecombinatorwordlistchains

Princeprocessor

Standalone password candidate generator using the PRINCE algorithm. Generates chains of combined words from a single input wordlist as an advanced combinator attack.

Description

Princeprocessor is a password candidate generator that can be thought of as an advanced combinator attack. Rather than taking two different wordlists and outputting all possible two-word combinations, it uses one input wordlist to build 'chains' of combined words. These chains can have 1 to N words from the input wordlist concatenated together.

The name PRINCE stands for PRobability INfinite Chained Elements, which are the building blocks of the algorithm. It is designed for generating password candidates efficiently, with options for optimization, resource control, and amplification to suit various attack scenarios.

Use cases include password cracking in penetration testing, where traditional combinators fall short, by leveraging probabilistic chaining for more targeted candidate generation.

How It Works

Princeprocessor operates by loading a single wordlist and generating infinite chained elements based on the PRINCE algorithm. It concatenates words into chains of variable length (1 to N elements), applying optimizations like length filters, element count limits, and dupe checks. Features such as case permutation amplify candidates by altering the case of the first letter in words.

Installation

bash

sudo apt install princeprocessor

Flags

-V, --versionPrint version

-h, --helpPrint help

--keyspaceCalculate number of combinations

--pw-min=NUMPrint candidate if length is greater than NUM

--pw-max=NUMPrint candidate if length is smaller than NUM

--elem-cnt-min=NUMMinimum number of elements per chain

--elem-cnt-max=NUMMaximum number of elements per chain

--wl-dist-lenCalculate output length distribution from wordlist

--wl-max=NUMLoad only NUM words from input wordlist or use 0 to disable

-c, --dupe-check-disableDisable dupes check for faster initial load

--save-pos-disableSave the position for later resume with -s

-s, --skip=NUMSkip NUM passwords from start (for distributed)

-l, --limit=NUMLimit output to NUM passwords (for distributed)

-o, --output-file=FILEOutput-file

--case-permuteFor each word in the wordlist that begins with a letter generate a word with the opposite case of the first letter

Examples

Print help and usage information

princeprocessor -h

Generate password candidates from the specified wordlist using default PRINCE chaining

princeprocessor wordlist

Calculate the number of combinations possible from the wordlist

princeprocessor --keyspace wordlist

Generate candidates and save to output file

princeprocessor -o output.txt wordlist

Generate candidates with password lengths between 8 and 12 characters

princeprocessor --pw-min=8 --pw-max=12 wordlist

Generate chains with 2 to 4 elements from the wordlist

princeprocessor --elem-cnt-min=2 --elem-cnt-max=4 wordlist

Generate candidates with case permutation on first letters

princeprocessor --case-permute wordlist

Skip first 1,000,000 candidates and limit output to 500,000 for distributed processing

princeprocessor -s 1000000 -l 500000 wordlist

Updated 2026-04-16kali.org ↗