MP64(1)

💖 MP64 — like, the word generator that EATS 💖

okay bestie, welcome to mp64(1), the high-performance word generator with a per-position configurable charset. buckle up, this one is a whole vibe 🦋

---

✨ SYNOPSIS ✨

mp64 [options]... mask

---

🌸 DESCRIPTION 🌸

Maskprocessor (yes, that's the whole name, she's iconic) is a fast word list generator. She enumerates all combinations from a user-defined keyspace and outputs the results. periodt.

The way that she supports different alphabets — and you can combine them — at different positions in the generation template (the mask), means you get way more fine-tunable candidate generation than just doing 'naive' brute force enumeration of words. no cap. Masks are defined using the same description that the Hashcat password recovery utility uses, so if you know one, you know the other 💅

High-Performance word generator with a per-position configureable charset ✨

---

🚀 Startup

• -V, --version — prints the version, obviously 💖
• -h, --help — prints the help. your bestie when you're lost 🫶

---

🔥 Increment

• -i, --increment=NUM:NUM — turns on increment mode. the 1st NUM is the start, the 2nd NUM is the stop. Example: -i 4:8 searches lengths 4-8 (inclusive). so satisfying 😭

---

🎀 Misc

• --combinations — calculates the number of combinations
• --hex-charset — assumes the charset is given in hex
• -q, --seq-max=NUM — maximum number of multiple sequential characters
• -r, --occurrence-max=NUM — maximum number of occurrence of a character

---

🧚 Resources

• -s, --start-at=WORD — start at a specific position
• -l, --stop-at=WORD — stop at a specific position

---

💜 Files

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

---

🍓 Custom charsets

• -1, --custom-charset1=CS — user-defineable charsets
• -2, --custom-charset2=CS — Example:
• -3, --custom-charset3=CS — --custom-charset1=?dabcdef
• -4, --custom-charset4=CS — sets charset ?1 to 0123456789abcdef

---

👑 Built-in charsets

?l = abcdefghijklmnopqrstuvwxyz
?u = ABCDEFGHIJKLMNOPQRSTUVWXYZ
?d = 0123456789
?s =  !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
?a = ?l?u?d?s
?b = 0x00 - 0xff

---

🌈 MASKS 🌈

so for every single position of the generated password candidates, we need to configure a placeholder. if a password we wanna crack has the length 8, then our mask has to consist of 8 placeholders. simple math bestie 💅

A mask is a simple string that configures the keyspace of the password candidate engine using placeholders. A placeholder can be:

• a custom charset variable,
• a built-in charset variable, or
• a static letter.

A variable is indicated by the ? letter followed by one of the built-in charset (l, u, d, s, a) or one of the custom charset variable names (1, 2, 3, 4). A static letter is not indicated by a letter. And the exception: if you want the static letter ? itself, it must be written as ??. yes, she's escaping herself, main character energy fr fr ✨

---

🦋 BUILTIN CHARSETS 🦋

?l = abcdefghijklmnopqrstuvwxyz, ?u = ABCDEFGHIJKLMNOPQRSTUVWXYZ, ?d = 0123456789, ?s = (space)!"#$%&'()*+,-./:;<=>?@[]^_`{|}~, ?a = ?l?u?d?s, ?b = 0x00-0xff

---

🎀 CUSTOM CHARSETS 🎀

There are four command line parameters to configure four custom charsets: --custom-charset1=CS, --custom-charset2=CS, --custom-charset3=CS, --custom-charset4=CS.

These command line parameters have four analogous shortcuts called -1, -2, -3 and -4. You can specify the chars directly on the command line. obsessed 😌

---

💫 PASSWORD LENGTH INCREMENT 💫

A Mask attack is always specific to a password length. Like, for example, if we use the mask ????l?l?l?l?l?l?l?l??? we can only crack a password of the length 8. But if the password we try to crack has the length 7? we will not find it. tragic 😭

That is why we have to repeat the attack several times, each time with one placeholder added to the mask. This is transparently automated by using the --increment flag. slay.

?l -> ?l?l -> ?l?l?l -> ?l?l?l?l -> ?l?l?l?l?l -> ?l?l?l?l?l?l -> ?l?l?l?l?l?l?l -> ?l?l?l?l?l?l?l?l

---

🙈 REPORTING BUGS 🙈

Please report bugs upstream to the maskprocessor issue tracker on GitHub:

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

(be nice, be specific, include the deets 💖)

---

💅 COPYRIGHT 💅

This tool is developed and maintained by Jens Steube under the MIT License.

---

and that's the whole page bestie 🫶 this was mp64 v0.73, dated December 2023, and yeah, she's MP64(1) and she ATE. go generate some words ✨💖🎀