# 🐺 Iron Emails Hunter

Complete User Guide & Documentation

### ⚡ What is Iron Emails Hunter?

Iron Emails Hunter is a professional email extraction tool that discovers email addresses from websites, IP addresses, and entire IP ranges. Perfect for marketing, lead generation, and research purposes.

## 🎯 Key Features

- Multi-Source Scanning: Extract emails from URLs, domains, IP addresses, and CIDR ranges
- Bulk Processing: Upload text files with thousands of targets
- Smart Filtering: Automatic duplicate removal and MX validation
- Forum Hunter: Deep scanning of vBulletin, phpBB, SMF, and Discourse forums
- File Discovery: Find emails in exposed .sql, .csv, .txt, .pdf files
- Real-Time Analytics: Live statistics, email rate tracking, and domain heatmaps
- Session Management: Auto-save progress every 30 seconds
- Export Options: Save results to CSV or TXT format

## 🚀 Getting Started

### 1. Interface Overview

The dashboard is divided into three main sections:

Section | Description
--- | ---
⚙ Configuration | Enter targets, configure threads/depth, enable hunting modes
📊 Statistics | View real-time stats, email rate, and control buttons
📧 Results | View extracted emails, activity log, and analytics

### 2. Adding Targets

You can add targets in multiple ways:

Manual Entry: Type directly into the input box
example.com company.net blog.website.org
IP Addresses: Single IPs or ranges
192.168.1.50 85.114.1.0/24 10.0.0.0/16
File Upload: Click 📁 Browse File to upload a .txt file with one target per line

## ⚙️ Configuration Settings

### Basic Settings

Setting | Recommended Value | Description
--- | --- | ---
Project Name | descriptive name | Name for saving/loading sessions
Threads | 75 | Number of concurrent connections (higher = faster but more aggressive)
Depth | 2 | How many levels deep to crawl links (1-5)
Strong URL Threshold | 50 | Minimum score for "strong" URL classification
Weak Domain Threshold | 50 | Minimum score for weak domain filtering
TLD Filter | optional | Only extract emails with specific TLDs (e.g., ".com .net .org")

### ✓ MX Validation

Keep this enabled to verify that email domains have valid mail servers. This filters out fake/invalid email addresses.

### 🎯 Deep Hunting Modes

Note: These are advanced features that significantly increase scan time and may trigger rate limiting.

⚠️ Use with Caution!

Deep hunting modes are powerful but aggressive. Only enable if you need maximum email extraction and understand the risks.

Mode | What It Does
--- | ---
🔍 Forum Detection | Identifies forum software (vBulletin, phpBB, SMF, Discourse) and deeply scrapes member profiles, posts, and pages
📂 Email-Rich Path Hunting | Targets pages likely to contain emails: /contact, /about, /team, /staff, /directory, etc.
🗺️ Sitemap Mining | Extracts URLs from sitemap.xml and robots.txt files for comprehensive coverage

### 🚫 Blocklist

Click 🚫 Blocklist to manage domains you want to exclude (test domains, disposable emails, spam traps, etc.)

## 📁 IP Range Format

Iron Emails Hunter supports CIDR notation for scanning IP ranges:

Format | Example | Coverage
--- | --- | ---
Single IP | 85.114.1.50 | 1 IP address
/32 | 85.114.1.50/32 | 1 IP address
/24 | 85.114.1.0/24 | 256 IP addresses (Class C)
/16 | 85.114.0.0/16 | 65,536 IP addresses
/8 | 85.0.0.0/8 | 16,777,216 IP addresses

# Example targets.txt file example.com 192.168.1.0/24 85.114.0.0/16 company.net 10.50.0.0/16 website.org

## ▶️ Running a Scan

1. Enter your targets (manual or file upload)
2. Configure settings (threads, depth, validation)
3. Optional: Enable deep hunting modes if needed
4. Click ⚡ START HUNTING EMAILS
5. Monitor progress in the Statistics panel
6. View results in real-time under the Emails tab

💡 Pro Tip: Sessions auto-save every 30 seconds! If you close the app or it crashes, use ↻ Load Session to resume where you left off.

## 📊 Understanding the Results

### Statistics Panel

Metric | Meaning
--- | ---
Unique Emails | Total unique email addresses found
Duplicates | Number of duplicate emails filtered out
URLs Scanned | Total number of pages crawled
Strong URLs | High-quality pages above the threshold score
Email Rate | Current extraction speed (emails per minute)

### Results Tabs

- 📧 Emails: Real-time list of discovered emails
- 📝 Activity: Detailed log of scanning activity
- 📊 Analytics: Email rate chart and top domains heatmap

## 💾 Exporting Results

When your scan is complete (or running), click ⭳ Export to save results.

Export Formats:

- CSV: Structured data with stats (opens in Excel)
- TXT: Simple text list (one email per line)
- Full Report: Complete statistics and metadata

⚠️ Trial Mode Restriction: Export and copy features are disabled in trial mode. Activate a license to unlock full functionality.

## 🔒 License & Activation

### Trial Mode

You can use Iron Emails Hunter in trial mode without a license:

- ✅ Full scanning functionality
- ✅ All hunting modes available
- ✅ Real-time analytics
- ❌ Copy/paste disabled
- ❌ Export disabled

### Licensed Version

Activate a license to unlock:

- ✅ Copy extracted emails
- ✅ Export to CSV/TXT
- ✅ Priority support
- ✅ Future updates included

Plans Available:

- Monthly License: $15/month - Cancel anytime
- Lifetime License: $99 one-time - Forever access

Buy License →

To activate, click the 🔑 Activate button in the License Status card and enter your license key.

## 💡 Tips & Best Practices

- Start Small: Test with a few targets before running large scans
- Optimize Threads: More threads = faster, but may trigger rate limits. Start with 75.
- Use Depth Wisely: Depth 2 is usually sufficient. Depth 3+ significantly increases scan time.
- Enable MX Validation: Always keep this on to filter invalid emails
- Check Analytics: Use the domain heatmap to identify rich email sources
- Save Sessions: Name your projects clearly for easy resumption
- Blocklist Management: Regularly update your blocklist to exclude unwanted domains

## ⚠️ Legal & Ethical Use

Important Notice:

Iron Emails Hunter is a powerful tool. Use it responsibly and ethically:

We are not responsible for misuse of this software.

## 🆘 Troubleshooting

### Common Issues

Q: No emails are being found

- Check that targets are accessible (not behind login/firewall)
- Try increasing scan depth
- Enable deep hunting modes
- Verify MX validation isn't too strict

Q: Scan is very slow

- Reduce thread count if you're getting rate limited
- Disable deep hunting modes if not needed
- Check your internet connection speed

Q: Application crashes or freezes

- Your session is auto-saved! Use Load Session to resume
- Try reducing threads to 50 or lower
- Close other programs to free up memory

Q: Can't copy or export results

- You're in trial mode - activate a license to unlock these features
- Click the 🔑 Activate button in the License Status card

## 📞 Support & Contact

Need help? We're here for you!