mentalist: graphical tool for custom wordlist generation

Mentalist is a graphical tool for custom wordlist generation. It utilizes common human paradigms for constructing passwords and can output the full wordlist as well as rules compatible with Hashcat and John the Ripper.


Linux (APT package manager)

Check if Python 3 is installed by running python3 –version. If it is not, run:

sudo apt-get update && apt-get install python3.6

Additionally, you will need setuptools and Tk:

sudo apt-get install python3-setuptools python3-tk


There are varying ways of installing Python 3 on OS X, but the easiest is to install through Homebrew.

brew update && brew install python3


If using Windows, please refer to Installing Python 3 on Windows from the Hitchhiker’s Guide. It is also extremely helpful to click the Python 3 installer checkbox to add Python to your PATH.

Install Mentalist

git clone
cd mentalist
python3 install



Full Wordlist

This option outputs the entire word list, as specified by the chain. The estimated number of words and filesize can be found in the top menu of Mentalist.

Hashcat/John Rules

For offline cracking, there are times where the full wordlist is too large to output as a whole. In this case, it makes sense to output to rules so that Hashcat or John can programmatically generate the full word list.

Note that the First and Last Substitution attributes are not compatible with Hashcat/John. When a chain contains these attributes, saving to Hashcat/John will warn that First or Last will be changed to All in the rules output.

Base Words Only

This output option allows you to output the base words into a single file to be used with your rules. This is useful if you have multiple sources of base words (multiple Base Word attributes).

The mentalist tutorial, please read the wiki.