ARP Spoofing Tool 🌐

🎯 Overview

Advanced network packet analysis and ARP spoofing tool built with Python. Featuring pattern matching, real-time monitoring, and beautiful reporting interfaces.

✨ Key Features

🔍 Network Analysis

• Real-time packet capture and filtering
• Pattern-based traffic monitoring
• MAC address resolution
• Hostname detection

🛡️ ARP Operations

• Smart gateway detection
• Target device mapping
• Traffic interception
• Custom packet rules

📊 Reporting & Export

• Interactive HTML reports
• JSON data export
• CSV compatibility
• Plain text logs

🖥️ Screenshots

ARP Spoofing Tool in Action

Initializes the tool and displays the status of the ARP spoofing attack.

Packet Capture Overview

Real-time packet capture showing intercepted network packets with source and destination details. (Press Ctrl+C to stop packet capturing)

Export Format Options

Options for exporting captured data in various formats such as HTML, JSON, CSV, and plain text.

HTML Report

Generated HTML report providing a detailed analysis of the captured packets.

🚀 Quick Start

# Clone repository
https://github.com/zeefxd/ARP-Spoofer.git
cd ARP-Spoofer

Install dependencies

pip install -r requirements.txt

Run with default settings

# Linux/macOS
sudo python -m src

# Windows (run PowerShell/CMD as Administrator)
python -m src

⚠️ Note: Root/Administrator privileges are required for network operations

💻 Usage Examples

Basic Monitoring:

# Linux/macOS
sudo python -m src --target 192.168.1.1

# Windows (run PowerShell/CMD as Administrator)
python -m src --target 192.168.1.1

Pattern Matching:

# Linux/macOS
sudo python -m src --patterns "HTTP,FTP"

# Windows (run PowerShell/CMD as Administrator)
python -m src --patterns "HTTP,FTP"

Custom Export:

# Linux/macOS
sudo python -m src --format json

# Windows (run PowerShell/CMD as Administrator)
python -m src --format json

Example:

# Linux/macOS
sudo python -m src -t 192.168.1.10 -g 192.168.1.1 -p "password" "secret" -f html

# Windows (run PowerShell/CMD as Administrator)
python -m src -t 192.168.1.10 -g 192.168.1.1 -p "password" "secret" -f html

📋 Command Options

Option	Description	Default
-t, --target	Target IP address	Auto-detect
-g, --gateway	Gateway IP address	Auto-detect
-p, --patterns	Search patterns	None
-f, --format	Export format	html

📁 Project Structure

src/
├── core/          # Core functionality
├── network/       # Network operations
├── spoofer/       # ARP implementation
├── models/        # Data models
└── utils/         # Helper functions

📦 Dependencies

• scapy - Network packet manipulation
• rich - Terminal UI components
• netifaces - Network interface handling
• jinja2 - Report templating

🔧 Development

# Setup development environment
python -m venv venv
source venv/Scripts/activate  # Windows
pip install -r requirements-dev.txt

⚠️ Security Notice

Educational Purposes Only: This tool should only be used on networks where you have explicit permission to test.

🤝 Contributing

1. Fork repository
2. Create feature branch
3. Commit changes
4. Push to branch
5. Submit pull request

📜 License

MIT License - See LICENSE file

👤 Author

GitHub: @zeefxd

Twitter: @zeefxd

💬 Support Report issues on GitHub