🔍 KeyHunter - Password Scanner for Wordlists

KeyHunter is a powerful command-line tool designed to efficiently and stylishly search for passwords in massive wordlist files. Perfect for security researchers, password auditors, and anyone interested in scanning large datasets for specific terms.

🚀 Key Features:

• 🔎 Efficient Searching: Scans large files in blocks, optimizing memory usage and maximizing speed.
• 🎳 Parallel Searching: Scans multiple files in blocks, optimizing memory 15x times more than the efficient searching.
• 📈 Progress Bar: Visualize the real time scanning progress for a more engaging experience.
• 🔴 Term Highlighting: Highlights search terms found in red, making them easy to spot in the output.
• 💡 Detailed Reports: Displays the total number of occurrences found and details of each match.
• 🔧 Configurable Options: Adjust block size and enable verbose mode to see detailed progress of each step.

🛠 Requirements

• Python version: Python 3.x
• Libraries: colorama, tqdm, Pillow, mmap

📥 Installation

1. Clone the repository:

git clone https://github.com/your-username/keyhunter.git
cd keyhunter

2. Install the dependencies:

pip install -r requirements.txt

Run the script:

python3 keyhunter.py <path-to-file> <search-term> [options]

📜 Usage Examples

• Search for passwords across multiple and different files (FASTER):

Note

For this option you should separate the wordlist in multiple files using the --split functionality (or by yourself) and then pass the folder as path.

python3 keyhunter.py /path/to/wordlist_parts/ password [-v] [--output /path/to/scan.txt]

• Search for passwords in a file (SLOWER):

python3 keyhunter.py /path/to/wordlist.txt password [-v] [--output /path/to/scan.txt]

• Split a file in multiple smaller ones (to split massive wordlists):

python3 keyhunter.py /path/to/wordlist.txt --split [--max_size 50]

• Export results to pdf:

python3 keyhunter.py /path/to/wordlist.txt search_term --pdf