Evil-M5Project is a versatile toolkit for ethical hacking and WiFi network exploration, designed for M5Stack hardware. It empowers users to scan, monitor, and interact with WiFi networks, offering a hands-on approach to understanding network security concepts and vulnerabilities.

How It Works

The project leverages M5Stack devices, such as the Core2, Cardputer, and AtomS3, to perform various WiFi-related operations. It supports features like network scanning, cloning, captive portal management, and deauthentication attacks. For advanced wardriving, it enables a master-slave architecture using multiple ESP32 devices, with GPS integration for location-tagged data collection compatible with Wigle.

Quick Start & Requirements

• Installation: Primarily via M5burner tool or by compiling with Arduino IDE.
• Prerequisites: M5Stack devices (Core2, Cardputer, Fire, AtomS3, etc.), SD Card (FAT32, max 16GB), optional GPS Module for wardriving.
• Compilation: Requires specific Arduino IDE ESP32 board versions (<= 2.1.1), libraries (M5GFX, M5Unified, etc.), and potentially disabling PSRAM. Cardputer requires specific flash/partition settings.
• Resources: SD card for startup images and sites.
• Documentation: https://github.com/7h30th3r0n3/Evil-M5Project/wiki

Highlighted Details

• Extensive feature set across various M5Stack hardware, detailed in a comparison table.
• Master-slave wardriving capability with up to 14 ESP32 devices for simultaneous channel monitoring.
• GPS integration for Wigle-compatible wardriving data logging.
• Includes advanced features like BadUSB, SSH Shell, and LLM Chat Stream on specific devices.

Maintenance & Community

• Active development with regular updates (v1.4.0 mentioned).
• Community support available via Discord.
• Project is supported through affiliate links for M5Stack products and AliExpress.

Licensing & Compatibility

• MIT License.
• Permits commercial use, modification, distribution, and sublicensing.

Limitations & Caveats

• Feature availability varies significantly across different M5Stack hardware models.
• Compilation requires careful attention to ESP32 board versions and specific Arduino IDE settings.
• Some advanced features like BadUSB and SSH are limited to specific devices.