🔍 HashEye - Advanced Hash Type Detection Tool

HashEye is a powerful Python CLI tool for instantly detecting and analyzing hash types. It provides detailed information about hash formats, security levels, entropy analysis, and pattern detection.

Powered by Isaac Security Labs

🔗 Links:

• GitHub: @ishaklaz
• Telegram: @isaacsecuritylabs

---

✨ Features

• 🔎 Multi-Format Detection: Supports hex and Base64 encoded hashes
• 🎯 Wide Hash Support: Detects MD5, SHA1, SHA224, SHA256, SHA384, SHA512, NTLM, bcrypt, scrypt, and more
• 📊 Entropy Analysis: Calculates Shannon entropy to assess hash randomness
• 🔒 Security Assessment: Provides security level ratings and recommendations
• 🎨 Pattern Detection: Identifies repeating characters and sequential patterns
• 📝 JSON Output: Optional JSON format for automation and scripting
• 📦 Batch Processing: Analyze multiple hashes from command line or file
• 🎨 Colorful Output: Beautiful ANSI-colored terminal output
• 🚀 Zero Dependencies: Uses only Python standard library

---

📋 Requirements

• Python 3.6 or higher
• No external dependencies required (standard library only)

---

🚀 Installation

Method 1: Direct Download

1. Download hasheye.py to your system
2. Make it executable (Linux/macOS):

   chmod +x hasheye.py
   

Method 2: Clone Repository

git clone https://github.com/ishaklaz/Hash-Eye.git
cd Hash-Eye

Method 3: Using pip (if available)

pip install -r requirements.txt

---

💻 Usage

Basic Usage

Analyze a single hash:

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592

Command-Line Options

python3 hasheye.py [OPTIONS] [HASH...]

Options:

• -h, --help Show help message and exit
• -j, --json Output results in JSON format
• -f, --file Read hashes from a file (one per line)
• -s, --simple Show simplified output without detailed analysis
• -v, --version Show version information

Examples

1. Single Hash Analysis

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592

Output:

[+] HashEye Result
──────────────────────────────────────────────────

Hash           : 5d41402abc4b2a76b9719d911017c592
Length         : 32
Format         : HEX
Type(s)        : MD5 / NTLM (possible) / LM Hash (possible)
Entropy        : 3.8750
Security Level : Weak
Recommendation : Consider upgrading to SHA-256 or SHA-512

──────────────────────────────────────────────────
Powered by Isaac Security Labs

2. JSON Output

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592 --json

Output:

{
  "hash": "5d41402abc4b2a76b9719d911017c592",
  "length": 32,
  "format": "hex",
  "types": [
    "MD5",
    "NTLM (possible)",
    "LM Hash (possible)"
  ],
  "entropy": 3.875,
  "security_level": "Weak",
  "recommendation": "Consider upgrading to SHA-256 or SHA-512",
  "pattern_analysis": {
    "case_mixed": false,
    "case_lower": true,
    "case_upper": false,
    "repeating_chars": [],
    "has_sequential": false
  }
}

3. Batch Processing (Multiple Hashes)

python3 hasheye.py hash1 hash2 hash3

4. Process Hashes from File

Create a file hashes.txt:

5d41402abc4b2a76b9719d911017c592
aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

Then run:

python3 hasheye.py --file hashes.txt

5. Simple Output (No Details)

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592 --simple

6. SHA-256 Hash Example

python3 hasheye.py e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

---

📊 Supported Hash Types

Hex Hashes

Length	Hash Types
32	MD5, NTLM (possible), LM Hash (possible)
40	SHA1, RIPEMD-160
56	SHA224
64	SHA256, SHA3-256, Blake2b-256, RIPEMD-256
96	SHA384
128	SHA512, SHA3-512, Blake2b-512

Base64 Hashes

Length	Hash Types
24	bcrypt (possible), scrypt (possible)
44	bcrypt, scrypt
60	Argon2 (possible)
86	bcrypt

---

🔍 Understanding the Output

Entropy

Entropy measures the randomness of a hash:

• High (>3.5): Good randomness, likely a proper hash
• Medium (2.5-3.5): Moderate randomness
• Low (<2.5): Low randomness, possible weak hash or pattern

Security Levels

• Strong: SHA-384, SHA-512 - Excellent security
• Moderate: SHA-224, SHA-256 - Adequate for most use cases
• Weak: MD5, SHA1, NTLM - Consider upgrading

Pattern Analysis

The tool detects:

• Repeating characters: Same character appearing multiple times consecutively
• Sequential patterns: Sequential numbers or characters
• Case analysis: Mixed case, all lowercase, or all uppercase

---

🛠️ Advanced Usage

Integration with Scripts

HashEye can be integrated into your scripts using JSON output:

#!/bin/bash
result=$(python3 hasheye.py "$hash" --json)
hash_type=$(echo "$result" | python3 -c "import sys, json; print(json.load(sys.stdin)['types'][0])")
echo "Detected: $hash_type"

Python Integration

import subprocess
import json

def detect_hash(hash_string):
    result = subprocess.run(
        ['python3', 'hasheye.py', hash_string, '--json'],
        capture_output=True,
        text=True
    )
    return json.loads(result.stdout)

info = detect_hash('5d41402abc4b2a76b9719d911017c592')
print(f"Type: {info['types'][0]}")
print(f"Security: {info['security_level']}")

---

📝 Examples of Common Hashes

MD5

python3 hasheye.py 5d41402abc4b2a76b9719d911017c592
# Length: 32, Type: MD5

SHA1

python3 hasheye.py aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d
# Length: 40, Type: SHA1

SHA256

python3 hasheye.py e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
# Length: 64, Type: SHA256

SHA512

python3 hasheye.py cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e
# Length: 128, Type: SHA512

---

🐛 Troubleshooting

Issue: Colors not displaying

Solution: Your terminal may not support ANSI escape codes. Colors are optional and don't affect functionality.

Issue: "Unknown / Not a valid hash format"

Solution: Ensure your hash string contains only hexadecimal characters (0-9, a-f, A-F) or valid Base64 characters.

Issue: File not found

Solution: Use absolute paths or ensure you're in the correct directory when using --file option.

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• Isaac Security Labs - For development and support
• Python community for excellent standard library

Connect with us:

• 🌐 GitHub: @ishaklaz
• 💬 Telegram: @isaacsecuritylabs

---

📧 Support

For issues, questions, or contributions: