evillcode

🔥 Evillcode - Modular MITM Framework

Modular cybersecurity framework developed in Python for analysis, monitoring, and simulation of MITM attacks in local networks. It allows students and professionals to understand the inner workings of networks, protocols, and vulnerabilities in controlled environments.

📌 Description Evillcode is a modular framework that allows:

• Network scanning and discovery of active devices
• Identification of IP addresses, MAC addresses, and hostnames
• Continuous network monitoring
• Simulation of MITM (Man-In-The-Middle) attacks
• HTTP traffic capture for credential hunting (controlled environments)

Designed with a practical approach for learning in cybersecurity and networking.

🧩 Framework modules

• 🔍 Scanner: Discovery of devices on the network
• 🧠 Resolver: Hostname and MAC identification
• ⚡ MITM Engine: ARP spoofing
• 📥 Sniffer: HTTP traffic capture
• 📊 Monitor: Detection of new devices

⚠️ Note

• It is recommended to run on Linux systems (Kali Linux, Ubuntu).
• Superuser (root) permissions are required.
• Make sure you have an internet connection to install dependencies.

Required tools

• nmap
• iptables
• python3
• pip

📦 Installation

Follow these steps to install and run the project correctly:

🔹 1. Clone the repository

• git clone https://github.com/AlexanderOrtizScript/evillcode.git

• cd evillcode

🔹 2. Install Python dependencies

⚡ Quick option (Kali / Ubuntu)

• sudo pip3 install -r requirements.txt --break-system-packages

🧠 Recommended option (virtual environment)

• sudo apt install python3-venv -y

• python3 -m venv venv

• source venv/bin/activate

• pip install -r requirements.txt

⚠️ Note

On some Linux distributions (such as Kali Linux), global installation with pip is restricted.

That is why --break-system-packages or a virtual environment is used.

🔹 3. Install system tools

• sudo apt update

• sudo apt install -y nmap python3-pip

🔹 4. Run the program

• sudo python3 evillcode.py

🚀 Usage

Run the script with administrator privileges:

bash

sudo python3 evillcode.py

🔄 System flow

🖥️ Select interface
→ 🔍 Network scan
→ 🎯 Target selection
→ ⚡ MITM + Sniffing
→ 📡 Real-time monitor

📁 Project structure

evillcode/
├── evillcode.py        # Main script
├── requirements.txt    # Dependencies
├── README.md           # Documentation
├── LICENSE             # MIT License
└── .gitignore          # Files ignored by Git

📌 Python dependencies

• colorama
• pyfiglet
• scapy

⚠️ Legal Notice

This software is designed exclusively for educational purposes and authorized security testing.

Using this tool on networks without explicit consent is illegal.

The author is not responsible for any misuse of the software.

👨‍💻 Author

Alexander Ortiz GitHub: https://github.com/AlexanderOrtizScript

⭐ Contributions

Contributions are welcome. You can fork the project and submit a pull request.

📄 License

This project is under the MIT license (you can change it if you wish).

🚀 Project status

🟢 Active development Current version: 1.0.0