https://github.com/mohmdfo/hashbuster
hashbuster is a simple yet effective hash cracking tool that attempts to crack MD5, SHA-1, and SHA-256 hashes using a wordlist-based attack. It leverages Python's hashlib for hash computation and itertools for wordlist iteration.
https://github.com/mohmdfo/hashbuster
cybersecurity hash-cracker md5 pentesting python sha1 sha256 wordlist
Last synced: about 1 year ago
JSON representation
hashbuster is a simple yet effective hash cracking tool that attempts to crack MD5, SHA-1, and SHA-256 hashes using a wordlist-based attack. It leverages Python's hashlib for hash computation and itertools for wordlist iteration.
- Host: GitHub
- URL: https://github.com/mohmdfo/hashbuster
- Owner: MohmdFo
- License: mit
- Created: 2025-02-10T16:30:30.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-18T05:50:05.000Z (over 1 year ago)
- Last Synced: 2025-04-05T18:13:31.686Z (about 1 year ago)
- Topics: cybersecurity, hash-cracker, md5, pentesting, python, sha1, sha256, wordlist
- Language: Python
- Homepage:
- Size: 45.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hashbuster
Hashbuster is a Python-based tool designed to help you crack MD5, SHA1, or SHA256 hashes using a wordlist. **This tool is intended for educational purposes and authorized security testing only. Unauthorized use is illegal and unethical.**
## Features
- **Multi-Algorithm Support:** Crack hashes using MD5, SHA1, or SHA256.
- **Simple CLI Interface:** Easily specify the target hash, wordlist, and hash algorithm.
- **Readable Code:** Designed for clarity and ease of modification.
- **Extensible:** Can be expanded with additional features (e.g., brute-force generation using `itertools`).
## Requirements
- Python 3.x
## Installation
1. **Clone the Repository**
```bash
git clone https://github.com/MohmdFo/hashbuster.git
```
2. **Navigate to the Project Directory**
```bash
cd hashbuster
```
## Usage
The script accepts three arguments:
- ``: The hash value you wish to crack.
- ``: The path to a text file containing candidate words (one per line).
- `-a` or `--algorithm`: The hash algorithm used (supported options: `md5`, `sha1`, `sha256`).
### Running the Script
Open your terminal and run the following command:
```bash
python run.py -a
```
#### Example
If you have a wordlist file named `10k-most-common.txt` and you want to crack the MD5 hash for the word "dragon", use the following command:
```bash
python run.py 8621ffdbc5698829397d97767ac13db3 10k-most-common.txt -a md5
```
If successful, you should see output similar to:
```
[*] Starting hash cracking using MD5 algorithm...
[+] Found the match on line 7
[+] Success! The hash corresponds to: 'dragon'
```
## Wordlist Format
Your wordlist should be a plain text file with one candidate password per line. For example:
```
password
123456
12345678
1234
qwerty
12345
dragon
```
## How It Works
1. **Hash Computation:**
Each candidate word from the wordlist is stripped of whitespace, encoded, and then hashed using the specified algorithm.
2. **Comparison:**
The computed hash is compared with the target hash provided by the user. If a match is found, the tool outputs the corresponding candidate word and its location in the wordlist.
3. **Feedback:**
If the password is found, the script prints a success message. If not, it informs the user that the password was not found in the wordlist.
## Contributing
Contributions are welcome! If you have ideas for improvements or additional features, please fork the repository and submit a pull request. Before contributing, ensure you adhere to the code style and test your changes thoroughly.
## Disclaimer
**WARNING:** This tool is for educational purposes and authorized penetration testing only. **Do not use this tool on any system or network without explicit permission.** The author is not responsible for any misuse or damage caused by this software.
## License
This project is licensed under the [MIT License](LICENSE).