CUPP is a simple Python tool that creates custom wordlists based on information such as names, nicknames, birthdays, and other details. It helps generate custom password wordlists for password auditing, cybersecurity learning, and authorized security testing. You can install and use CUPP on Linux systems using a few simple commands.
How to Install CUPP Tool
Below are the simple commands to install CUPP on Linux.
Update package repositories.
apt update && apt upgrade -y
Install Git and Python.
apt install git python -y
Clone the CUPP repository.
git clone https://github.com/Mebus/cupp.git
Move into the CUPP directory.
cd cupp
Display the help menu.
python3 cupp.py -h
How to Use CUPP Tool
Start interactive mode.
python3 cupp.py -i
After running the command, CUPP will ask several questions about the target profile. Enter the available information and press Enter for any field you want to skip.
[+] Insert the information about the victim to make a dictionary [+] If you don't know all the info, just hit enter when asked! ;) > First Name: John > Surname: Wistone > Nickname: john > Birthdate (DDMMYYYY): 01012001 > Partners) name: A Wistone > Partners) nickname: A > Partners) birthdate (DDMMYYYY): 01012001 > Child's name: Robert > Child's nickname: Dev > Child's birthdate (DDMMYYYY): 01012026 > Pet's name: Rocky > Company name: > Do you want to add some key words about the victim? Y/[N]: n > Do you want to add special chars at the end of words? Y/[N]: n > Do you want to add some random numbers at the end of words? Y/[N]: n > Leet mode? (i.e. leet = 1337) Y/[N]: n [+] Now making a dictionary... [+] Sorting list and removing duplicates... [+] Saving dictionary to john.txt, counting 2000 words. > Hyperspeed Print? (Y/n) :
After answering the questions, CUPP automatically generates a custom wordlist and saves it as a text file. In this example, the generated wordlist is saved as john.txt.
Improve an existing wordlist.
python3 cupp.py -w wordlist.txt
Download large wordlists.
python3 cupp.py -l
Parse usernames and passwords from Alecto DB.
python3 cupp.py -a
Show the installed version.
python3 cupp.py -v
Display the help menu.
python3 cupp.py -h
Choose the option you want and CUPP will automatically perform the selected task and generate the appropriate output.
CUPP Tool Overview
CUPP is a useful wordlist generation tool that creates custom password dictionaries from user-provided information. It is commonly used for learning password profiling concepts and performing authorized password auditing and security testing activities.



