Ch4120N MD5 Hash Cracker

Multi-Threaded MD5 Hash Cracker with Smart Distribution

Ch4120N MD5 Hash Cracker is a powerful, high-performance, cross-platform MD5 hash cracking tool with multi-threading support and intelligent workload distribution.

👨‍💻 Project Programmer

Ch4120N — Ch4120N@Proton.me

🧠 Made For

Security professionals and penetration testers who require a powerful MD5 hash cracker with intelligent workload distribution for authorized security audits, forensic analysis, and password recovery.

🖼️ Screenshots

Usage	Cracking Progress

✨ Features

⚡ Performance & Efficiency

Multi-threading: Automatically detects CPU cores and utilizes all available threads
Optimized Work Distribution: Intelligent task partitioning for maximum throughput
Real-time Progress Monitoring: Live hash rate display and progress tracking
High-Speed Cracking: Capable of processing millions of hashes per second

🎯 Advanced Capabilities

Custom Character Sets: Flexible charset configuration with elimination of duplicates
Variable Password Length: Support for minimum and maximum password lengths
Verbose Mode: Detailed real-time output for debugging and analysis
Color-coded Output: Beautiful terminal interface with cross-platform color support
Thread-Safe Operations: Safe concurrent hash computation and state management

🔧 Technical Excellence

Cross-Platform: Native support for Windows (MSVC/MinGW), Linux, and macOS
Modern C++17: Leverages latest C++ features for optimal performance
Professional Build System: CMake-based with proper dependency management
Clean Architecture: Well-structured object-oriented design with proper RAII

💻 Supported Platforms

Linux (All distributions)
Windows (10+)
macOS (All versions)

🛠️ Build Instructions

Prerequisites

C++17 compatible compiler (g++ 8+, clang 7+, MSVC 2019+)
CMake 3.16+
Git (for cloning)

Platform-Specific Builds

Windows (MSVC)

mkdir build && cd build
cmake .. -G "Visual Studio 16 2019" -DUSE_MSVC=ON
cmake --build . --config Release

Windows (MinGW)

mkdir build && cd build
cmake .. -G "MinGW Makefiles" -DUSE_MINGW=ON
mingw32-make

Linux

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)

MacOSX

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(sysctl -n hw.ncpu)

Advanced Build Options

# Enable verbose mode compilation
cmake .. -DCMAKE_VERBOSE_MAKEFILE=ON

# Build with clang
cmake .. -DCMAKE_CXX_COMPILER=clang++

# Enable address sanitizer (debug builds)
cmake .. -DCMAKE_BUILD_TYPE=Debug -DENABLE_ASAN=ON

🚀 Quick Start

Installation

Method 1: From Source (Recommended)

# Clone the repository
git clone https://github.com/Ch4120N/ChMD5Cracker.git
cd ChMD5Cracker

# Build the project
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .

# The executable will be available at build/bin/chMd5Cracker

Method 2: Using Pre-built Binaries

Check the Releases page for pre-compiled binaries for your platform.

Basic Usage

./chMd5Cracker <character_set> <min_length> <max_length> <target_hash>

Example Commands

# Crack a 4-6 character alphanumeric password
./chMd5Cracker aAn 4 6 5f4dcc3b5aa765d61d8327deb882cf99

# Crack with verbose output (shows all attempts)
./chMd5Cracker aAnsv 1 8 e99a18c428cb38d5f260853678922e03

# Full character set brute-force
./chMd5Cracker aAnsv 1 6 098f6bcd4621d373cade4e832627b4f6

📖 Character Set Options

Option	Description	Characters Included
`a`	Lowercase letters	`abcdefghijklmnopqrstuvwxyz`
`A`	Uppercase letters	`ABCDEFGHIJKLMNOPQRSTUVWXYZ`
`n`	Numbers	`0123456789`
`s`	Special symbols	`!"$%&/()=?-.:\*'-_:.;,`
`m`	Mixed case (equivalent to aA)	Both lowercase and uppercase
`v`	Verbose mode	Enables detailed output

Note: Character sets are automatically de-duplicated. Combining a and m won't create duplicates.

📊 Performance Metrics

Platform	CPU	Threads	Hash Rate
Windows 11	i9-13900K	32	~2.1M hashes/sec
Linux (Ubuntu)	Ryzen 9 7950X	32	~2.4M hashes/sec
macOS	M2 Max	12	~1.8M hashes/sec
Windows 10	i5-10400	12	~850K hashes/sec

Note: Performance varies based on password length, character set size, and system load.

🏗️ Project Structure

ChMD5Cracker/
├── src/
│   ├── chMd5Cracker.cpp      # Main application source
│   └── include/              # Header files
│       ├── hash.h            # MD5 hashing implementation
│       ├── color.h           # Cross-platform color utilities
│       └── decorators.h      # Output formatting utilities
├── CMakeLists.txt            # Cross-platform build configuration
├── LICENSE                   # MIT License
└── README.md                 # This file

Core Components

Ch4120N_MD5_HASH_CRACKER Class - Main application controller
Thread Pool System - Dynamic thread management and task distribution
MD5 Hash Engine - Optimized hash computation with thread safety
Progress Monitor - Real-time performance tracking
Console Interface - Cross-platform color and formatting

🔍 Technical Details

Thread Pool Implementation

Dynamic Worker Allocation: Automatically scales based on CPU cores
Task Queue System: Efficient work distribution with load balancing
Thread Safety: Proper synchronization with mutexes and atomic operations
Graceful Shutdown: Clean termination on completion or interrupt

MD5 Hash Algorithm

Optimized Computation: Fast hash generation with minimal overhead
Thread-Safe Wrapper: ThreadSafeMD5 class for concurrent operations
Standard Compliant: Produces RFC 1321 compliant MD5 hashes

Character Generation

Recursive Backtracking: Efficient combination generation
Range Partitioning: Distributed first-character approach
Early Termination: Immediate stop on password discovery

🎨 User Interface

Color Scheme

Red: Banners and important warnings
Green: Success messages and found passwords
Blue: Information and headers
Cyan: Progress indicators
Magenta: Hash comparisons
White: Regular output

Real-time Display

Speed: 1,250,342 hashes/sec | Total: 45 secs

Completion Output

PASSWORD CRACKED SUCCESSFULLY!
Target Hash: 5f4dcc3b5aa765d61d8327deb882cf99
Password: password123
Time elapsed: 67 seconds

⚠️ Legal & Ethical Usage

Intended Purpose

This tool is designed for:

Password recovery for legitimate system access
Security auditing and penetration testing (with proper authorization)
Educational purposes in cryptography and security courses
Testing password strength in controlled environments

Legal Restrictions

Never use this tool on systems you don't own or have explicit permission to test9
Respect privacy laws and regulations (GDPR, CCPA, etc.)
Use only for ethical security testing with written authorization
The developer is not responsible for misuse or illegal activities

Responsible Disclosure

If you discover vulnerabilities in systems using this tool:

Stop testing immediately
Document your findings
Report to the system owner through proper channels
Do not disclose publicly until patched

🆘 Troubleshooting

Issue	Solution
"No targets specified and no makefile found"	Delete `build/` directory and regenerate with proper generator
Colors not displaying on Windows	Tool automatically enables ANSI escape codes on Windows 10+
Low performance	Ensure system power settings are on "High Performance"
Memory usage high with large charsets	Consider using smaller character sets or shorter max lengths

Debug Mode

# Enable verbose compilation
cmake .. -DCMAKE_VERBOSE_MAKEFILE=ON

# Run with gdb (Linux/macOS)
gdb --args ./chMd5Cracker a 1 4 5f4dcc3b5aa765d61d8327deb882cf99

# Check system compatibility
./chMd5Cracker

❤️ Support the Project

If you find this tool useful, consider donating:

Cryptocurrency	Address
BTC	`bc1ql4syps7qpa3djqrxwht3g66tldyh4j7qsyjkq0`
ETH	`0xfddbd535a4ad28792cbebceee3d6982d774e6d13`
USDT	`3Cq6HRQsiwZFmPEQfG9eJkZE2QGChvf2VN`

💖 Your support helps keep the project alive and improving!

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

Development Guidelines

Follow existing code style and formatting
Add comprehensive comments for complex logic
Include tests for new features
Update documentation as needed
Ensure cross-platform compatibility

🙏 Acknowledgments

MD5 Algorithm: Based on RSA Data Security, Inc. MD5 Message-Digest Algorithm
Threading Model: Inspired by modern C++ concurrency patterns
Color Output: Cross-platform ANSI escape sequence implementation
Build System: Professional CMake configuration for multi-platform support

🚨 Reporting Issues

If you encounter bugs, configuration issues, or unexpected behavior, please reach out: 📩 Ch4120N@Proton.me

"Through the rivers of cryptographic challenges, Ch4120N ferries your password recovery needs."

⭐ If you like this project, don't forget to give it a star!

Made with ❤️ by Ch4120N

Name		Name	Last commit message	Last commit date
Latest commit History 122 Commits
images		images
src		src
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md

License

Ch4120N/ChMD5Cracker

Folders and files

Latest commit

History

Repository files navigation