hashCrack: Hashcat made Easy

A sophisticated Python-based wrapper for Hashcat. The tool provides a streamlined approach to various attack modes, making advanced password recovery more accessible.

Caution

This tool is strictly for authorized security testing and educational purposes. Always obtain explicit permission before conducting any network assessments.

🚀 Key Features

• 🔐 Multiple Attack Modes

  • Wordlist attacks
  • Rule-based cracking
  • Brute-force strategies
  • Hybrid attack combinations

• 🖥️ Cross-Platform Compatibility

  • Optimized for Linux environments
  • Experimental Windows support via WSL

• 📊 Intelligent Interface

  • Interactive menu system
  • Session restoration
  • Comprehensive logging

💻 System Requirements

🐧 Recommended: Linux Environment

• Distributions:
  • Kali Linux
  • Ubuntu
  • Debian
  • Fedora
  • Arch Linux

🪟 Windows Support: Proceed with Caution

• Current Status: Experimental
• Recommended Approach:
  • Use Windows Subsystem for Linux (WSL)
  • Prefer native Linux installation

Warning

Windows support is not fully tested. Strong recommendation to use WSL or a Linux environment for optimal performance.

🔧 Dependencies Installation

Linux Installation

# Kali/Debian/Ubuntu
sudo apt update && sudo apt install hashcat python3 python3-pip python3-termcolor pipx

# Fedora
sudo dnf install hashcat python3 python3-pip python3-termcolor python3-pipx

# Arch Linux/Manjaro
sudo pacman -S hashcat python python-pip python-termcolor python-pipx

Windows Installation

1. Install Windows Subsystem for Linux (WSL)
2. Follow Linux installation instructions within WSL

📦 Installation & Usage

Install via pip

pipx install hashcrack-tool

Important

Ensure ~/.local/bin is in your PATH variable.

Running hashCrack

# Run hashCrack with hash file
hashcrack hashfile

Upgrading

pipx upgrade hashcrack-tool

🛠 Optional Setup

Download Default Wordlists

git clone https://github.com/ente0/hashcat-defaults

🎬 Demo Walkthrough

hashcrack_demo.mp4

Tip

Cracking results are automatically stored in ~/.hashCrack/logs/session/status.txt

🎮 Menu Options

Option	Description	Function
1 (Mode 0)	Wordlist Crack	Dictionary-based attack
2 (Mode 9)	Rule-based Crack	Advanced dictionary mutations
3 (Mode 3)	Brute-Force Crack	Exhaustive password generation
4 (Mode 6)	Hybrid Crack	Wordlist + mask attack
0	Clear Potfile	Reset previous cracking results
X	OS Menu Switch	Update OS-specific settings
Q	Quit	Exit the program

Example Hashcat Commands

# Wordlist Attack
hashcat -a 0 -m 400 example400.hash example.dict

# Wordlist with Rules
hashcat -a 0 -m 0 example0.hash example.dict -r best64.rule

# Brute-Force
hashcat -a 3 -m 0 example0.hash ?a?a?a?a?a?a

# Combination Attack
hashcat -a 1 -m 0 example0.hash example.dict example.dict

📚 Recommended Resources

Wordlists & Dictionaries

• 📖 SecLists
• 🌐 WPA2 Wordlists
• 🇮🇹 Parole Italiane

Hashcat Tools & Rules

• 🔧 Hashcat Defaults
• 📏 Hashcat Rules

🎓 Learning Resources

WPA2 Handshake Capture

• 4-Way Handshake Guide
• Practical Attack Demonstration

Technical Documentation

• Hashcat Wiki
• Radiotap Introduction
• Aircrack-ng Guide

📝 License

Licensed under the project's original license. See LICENSE file for details.

🤝 Support and Contributions

• 🐛 Report Issues
• 📧 Contact: [email protected]

Important

Always use these resources and tools responsibly and ethically. Respect legal and privacy boundaries.