PRINCEPROCESSOR(1)

📦
version 0.22 · 4 versions
, in debian trixie, ubuntu noble, ubuntu questing

💖 PRINCEPROCESSOR 💖

okay bestie, welcome to princeprocessor, aka the standalone password candidate generator that runs on the PRINCE algorithm. it lives in section 1 of the user commands manual, and it's genuinely iconic. 🎀

✨ NAME ✨

princeprocessor — standalone password candidate generator using the PRINCE algorithm

like. that's her. that's the whole vibe. no cap. 💅

🌈 SYNOPSIS 🌈

princeprocessor [options] [<] wordlist

👑 DESCRIPTION 👑

so princeprocessor is a password candidate generator, and honestly the easiest way to picture it is as an advanced combinator attack. but here's the plot twist: a normal combinator attack takes two different wordlists and spits out every possible two-word combo. princeprocessor? she only takes one input wordlist and builds "chains" of combined words. and those chains can be anywhere from 1 to N words from the input wordlist, all concatenated together. it's giving glow-up. ✨

🌸 Startup 🌸

the basics, the essentials, the getting-started energy 🫶

  • -V, --version — print version. that's it, that's the whole job. 💅
  • -h, --help — print help. when in doubt, ask her. 🙈

🦋 Misc 🦋

  • --keyspace — calculate number of combinations. the math girlies ate. 🔥

⚡ Optimization ⚡

tuning her up so she runs faster, slay 💅

  • --pw-min=NUM — print candidate if length is greater than NUM
  • --pw-max=NUM — print candidate if length is smaller than NUM
  • --elem-cnt-min=NUM — minimum number of elements per chain
  • --elem-cnt-max=NUM — maximum number of elements per chain
  • --wl-dist-len — calculate output length distribution from wordlist
  • --wl-max=NUM — load only NUM words from input wordlist, or use 0 to disable
  • -c, --dupe-check-disable — disable dupes check for faster initial load
  • --save-pos-disable — save the position for later resume with -s

🎀 Resources 🎀

for when you're splitting the work across machines, main character distributed energy 💖

  • -s, --skip=NUM — skip NUM passwords from start (for distributed)
  • -l, --limit=NUM — limit output to NUM passwords (for distributed)

🍓 Files 🍓

  • -o, --output-file=FILE — output-file

🧚 Amplifier 🧚

  • --case-permute — for each word in the wordlist that begins with a letter, generate a word with the opposite case of the first letter

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence bestie. please report bugs upstream to the princeprocessor issue tracker on GitHub:

https://github.com/hashcat/princeprocessor/issues

this tool is developed and maintained by Jens Steube under the MIT License. respect the queen 👑

and that's the whole page, fr fr. this was princeprocessor v0.22, from December 2023, and yes it's still PRINCEPROCESSOR(1) in the manual. mwah 💋 bye bestie!! 🦋✨

📦 where this page comes from