Evil-M5Project - Evil-M5Project is an innovative tool developed for

项目说明

<di="center">

# E

<img src=" width="300" />

<b>E</b> is an inno 工具 de for ethical testing and exploration of WiFi networks. It harnesses the power of the M5Core2 device to scan, monitor, and interact with WiFi networks in a controlled en. This project is designed for educational purposes, aiding in understanding 网络 security and .

> <i>Disclaimer</i>: The creator of E is not responsible for any misuse of this 工具. It is intended solely for ethical and educational purposes. Users are reminded to comply with all applicable laws and regulations in their jurisdiction. All files provided with E are designed to be used in a controlled en and must be used in compliance with all applicable laws and regulations. Misuse or illegal use of this 工具 is strictly prohibited and not supported by the creator.

#### E

<img src="./Github-Img/M5family.jpg" width="300" />
<img src="./Github-Img/CYD-Stick.jpg" width="200" />

<hr />
<h2 style="text-align:center;">☕️ Support This Project</h2>

<p style="text-align:center; font-size:1.1em;">
If you find this project useful, consider supporting its de! <br> ⭐ leave a star, it can really help ⭐ !
</p>

<!-- Ko-fi -->
<di="text-align:center; margin: 1em 0;">
<a href=" target="_blank" style="text-decoration:none;">
<img src=" alt="Support me on Ko-fi" />
</a>
</div>

<!-- M5 Affiliate -->
<di="text-align:center; margin: 2em 0;">
<a href=" target="_blank">
<img src=" alt="Support shop" width="120" />
</a>
<p><a href=" target="_blank"><strong>Buy M5Stack product</strong></a> <br />using my affiliate link to help me keep building new tools 🛠️</p>
</div>

<!-- AliExpress -->
<di="text-align:center; margin: 2em 0;">
<a href=" target="_blank">
<img src=" alt="AliExpress Logo" width="120" style="margin-bottom: 0.5em;" />
</a>
<p>
<a href=" target="_blank"><strong>Buy anything on AliExpress</strong></a><br />
<span>Just by using this link before searching, you're directly supporting the project 🙌</span>
</p>
</div>

<p><em>Every small click and donation keeps this open-源码 project alive ✨ just clicking can make a difference 😊</em></p>

<hr />

</br>

Join the E discord for help and updates 😉:

<a href="
<img src=" width="75" alt="Join Discord" />
</a>

---

For More Information Check The Wiki !

<a href="
<img src="./Github-Img/wiki.png" width="300" alt="For More Information Check The Wiki !" />
</a>

---

Compatible Hardware

<h2>🧱 M5Stack Devices</h2>
<table>
<tr>
<th>Device</th>
<th>Links to buy</th>
</tr>
<tr>
<td> Better one : M5Cardputer</td>
<td><a href=" / <a href="
</tr>
<tr>
<td>M5Stack Core2</td>
<td><a href=" / <a href="
</tr>
<tr>
<td>M5Stack Fire</td>
<td><a href="
</tr>
<tr>
<td>M5Stack Core1</td>
<td><a href="
</tr>
<tr>
<td>M5Stack AWS</td>
<td><a href="
</tr>
<tr>
<td>M5Stack CoreS3</td>
<td><a href=" / <a href="
</tr>
<tr>
<td>M5Stack CoreS3 SE</td>
<td><a href="
</tr>
<tr>
<td>M5AtomS3 (GPS needed)</td>
<td><a href="
</tr>
<tr>
<td>↳ GPS Module</td>
<td><a href="
</tr>
<tr>
<td>LLM Module</td>
<td><a href=" / <a href="
</tr>
</table>

<h2>🧪 In Beta</h2>
<table>
<tr>
<th>Device</th>
<th>Links</th>
</tr>
<tr>
<td>CYD2USB</td>
<td><a href="
</tr>
<tr>
<td>CYD1USB</td>
<td><em>(No link yet)</em></td>
</tr>
<tr>
<td>M5Stick v1.1</td>
<td><a href="
</tr>
<tr>
<td>M5Stick v2</td>
<td><a href="
</tr>
</table>
</div>
<h2>📦 Required Extras</h2>
<ul>
<li><strong>SD Card</strong> (FAT32, SDHC, max 16Go – 8Go is already enough)</li>
<li><strong>GPS Module</strong>:
<a href=" /
<a href="
</li>
</ul>

---

Features may vary depending on the firmware/device you are using:
| Feature | E v1.5.4 | E 1.3.9 | E 1.1.9 | E v1.1.7 | E v1.0 |
|-------------------------------|-----------------------|--------------------|--------------------|--------------------|----------------|
| WiFi Network Scanning | ✅ | ✅ | ✅ | ✅ | ❌ |
| Network Cloning | ✅ | ✅ | ✅ | ✅ | ❌ |
| Capti Management | ✅ | ✅ | ✅ | ✅ | ❌ |
| Credential Handling | ✅ | ✅ | ✅ | ✅ | ❌ |
| Remote Web Server | ✅ | ✅ | ✅ | ✅ | ❌ |
| Probes Attack | ✅ | ✅ | ✅ | ✅ | ❌ |
| Sniffing probes | ✅ | ✅ | ✅ | ✅ | ❌ |
| Karma Attack | ✅ | ✅ | ✅ | ✅ | ❌ |
| Automated Karma Attack | ✅ | ✅ | ✅ | ✅ | ✅ |
| Karma Spear | ✅ | ✅ | ✅ | ❌ | ❌ |
| Bluetooth Keyboard | ✅ | ✅ | ❌ | ❌ | ❌ |
| Wardriving | ✅ | ✅ | ✅ | ✅ | ❌ |
| Wardriving Master | ✅ | ❌ | ❌ | ❌ | ❌ |
| Beacon Spam | ✅ | ✅ | ✅ | ✅ | ❌ |
| Deauther | ✅ | ✅ | ❌ | ❌ | ❌ |
| Auto Deauther | ✅ | ❌ | ❌ | ❌ | ❌ |
| E | ✅ | ❌ | ❌ | ❌ | ❌ |
| Handshake Master | ✅ | ✅ | ❌ | ❌ | ❌ |
| Check Handshakes | ✅ | ❌ | ❌ | ❌ | ❌ |
| Client Sniff | ✅ | ✅ | ❌ | ❌ | ❌ |
| Raw Sniffing | ✅ | ✅ | ❌ | ❌ | ❌ |
| Wi-Fi Channel | ✅ | ✅ | ❌ | ❌ | ❌ |
| Client Sniff And Deauth | ✅ | ✅ | ❌ | ❌ | ❌ |
| EAPOL/Deauth detection | ✅ | ✅ | ✅ (No EAPOL) | ❌ | ❌ |
| Wall Of Flipper | ✅ | ✅ | ✅ | ❌ | ❌ |
| Send tesla code with RFunit | ✅ | ❌ | ❌ | ❌ | ❌ |
| Scan Network and port | ✅ | ✅ | ❌ | ❌ | ❌ |
| Full Network and port Scan | ✅ | ✅ | ❌ | ❌ | ❌ |
| SSH Shell | ✅ | ❌ | ❌ | ❌ | ❌ |
| Web Crawler | ✅ | ❌ | ❌ | ❌ | ❌ |
| PwnGrid | ✅ | ✅ | ❌ | ❌ | ❌ |
| Skimmer Detector | ✅ | ✅ | ❌ | ❌ | ❌ |
| Mouse Jiggler | ✅ | ❌ | ❌ | ❌ | ❌ |
| BadUSB | ✅ | ❌ | ❌ | ❌ | ❌ |
| WebUi BadUSB | ✅ | ❌ | ❌ | ❌ | ❌ |
| Customing Theming | ✅ | ✅ | ❌ | ❌ | ❌ |
| Full Network Scan | ✅ | ✅ | ❌ | ❌ | ❌ |
| Reverse TCP Tunnel | ✅ | ✅ | ❌ | ❌ | ❌ |
| DHCP Star | ✅ | ✅ | ❌ | ❌ | ❌ |
| Rogue DHCP | ✅ | ✅ | ❌ | ❌ | ❌ |
| Switch DNS | ✅ | ✅ | ❌ | ❌ | ❌ |
| Network Hijacking | ✅ | ✅ | ❌ | ❌ | ❌ |
| Detect Printer | ✅ | ✅ | ❌ | ❌ | ❌ |
| File Print | ✅ | ✅ | ❌ | ❌ | ❌ |
| Check printer status | ✅ | ✅ | ❌ | ❌ | ❌ |
| HoneyPot | ✅ (with Webhook) | ✅ | ❌ | ❌ | ❌ |
| LLM Chat Stream | ✅ | ❌ | ❌ | ❌ | ❌ |
| E | ✅ | ❌ | ❌ | ❌ | ❌ |
| SD on USB | ✅ | ❌ | ❌ | ❌ | ❌ |
| Responder | ✅ | ❌ | ❌ | ❌ | ❌ |
| WPAD Abuse | ✅ | ❌ | ❌ | ❌ | ❌ |
| Crack NTLMv2 | ✅ | ❌ | ❌ | ❌ | ❌ |
| File Manager | ✅ | ❌ | ❌ | ❌ | ❌ |
| UART Shell | ✅ | ❌ | ❌ | ❌ | ❌ |
| SIP ToolKit | ✅ | ❌ | ❌ | ❌ | ❌ |
| CCT | ✅ | ❌ | ❌ | ❌ | ❌ |
| SSDP Poisoner | ✅ | ❌ | ❌ | ❌ | ❌ |
| SkyJack | ✅ | ❌ | ❌ | ❌ | ❌ |
| WiFi Dead Drop | ✅ | ❌ | ❌ | ❌ | ❌ |
| BLENameFlood | ✅ | ❌ | ❌ | ❌ | ❌ |
| Wall Of Airtag | ✅ | ❌ | ❌ | ❌ | ❌ |
| FindMyEvil | ✅ | ❌ | ❌ | ❌ | ❌ |
| UPnP Mapping | ✅ | ❌ | ❌ | ❌ | ❌ |
| UPnP NAT | ✅ | ❌ | ❌ | ❌ | ❌ |
| LDAPDump | ✅ | ❌ | ❌ | ❌ | ❌ |
| IMSI Catcher | ✅ | ❌ | ❌ | ❌ | ❌ |
| Open Wifi Checker | ✅ | ❌ | ❌ | ❌ | ❌ |
| ESP32-C5 Serial Toolkit | ✅ | ❌ | ❌ | ❌ | ❌ |
| Aircrack (WPA2 Cracking) | ✅ | ❌ | ❌ | ❌ | ❌ |
| Autodisco | ✅ | ❌ | ❌ | ❌ | ❌ |
| E WebUI | ✅ | ❌ | ❌ | ❌ | ❌ |
| CIW ZeroClick | ✅ | ❌ | ❌ | ❌ | ❌ |
| TagTinker ESL | ✅ | ❌ | ❌ | ❌ | ❌ |
| CSI Radar | ✅ | ❌ | ❌ | ❌ | ❌ |
| Settings | ✅ | ✅ | ✅ | ✅ | ❌ |

----------------------------------------------------------

Installation

🌐 Web Flasher (easiest, no install)

Flash E from your browser with Web Serial — no M5Burner, no esptool, nothing to install.

👉 Open the E

1. Prepare your SD card first (the evil/ folder is mandatory — see below).
2. Open the flasher in Chrome or Edge on a desktop (Firefox, Safari, iOS and Android are not supported).
3. Plug in your device over USB, pick it from the list, click Install and choose the serial port.

Supported: M5Cardputer, Cardputer AD, CoreS3 / SE, Core2, Fire, StickC Plus/Plus2, CYD (1×/2×USB), and the AWOK Dual ESP32 Mini v2 port.

M5burner

1. Connect your device to your computer.
2. Download M5burner in UIFLOW FIRMWARE BURNING 工具 section : M5Stack Download Center
3. Place the necessary SD file content at the root of SD card. (This is needed to access all the files of the project).⚠️ the SD-Card-Folder files now need to be in a folder named evil at root of the sd card ⚠️
4. Type "evil-" in search bar and check for the device you have.
5. Click download and flash.

Compile Yourself

1. Connect your device to your computer.
2. Open the Arduino IDE and load the provided 代码.
3. Ensure the Board tutorial from M5 and Adafruit_NeoPixel, ArduinoJson, ESPping, IniFile, M5GFX, M5Unified, TinyGPSPlus, and esp8266audio libraries are installed. Follow these tutorials for guidance on M5 Board tutorial:
- Arduino Board Setup
- Arduino Library Installation
4. Ensure the ESP32 and M5Stack board definitions are installed. Note: Errors occur with ESP32 3.0.0-alpha3 for no M5stack devices. Please use M5stack board with ESP32 2.1.4 and below.
5. Place the necessary SD file content at the root of SD card. (This is needed to access the IMG startup and sites folder). ⚠️ the SD-Card-Folder files now need to be in a folder named evil at root of the sd card ⚠️
6. (Optional) Edit theme.ini on the SD card to customize your device's color theme. (Only supported for cardputer, other devices to be implemented later)
7. Ensure to run the script in utilities/deauth_prerequisites to bypass the ESP32 firmware.
8. Add libraries for BadUSB functionality. See utilities/Bad_Usb_Lib/README.md
9. Ensure that the baud rate is set to 115200.
10. Ensure that PSRAM is disabled in the tools menu.
11. Upload the script to your M5Core2 device.
12. Restart the device if needed.

Warning : for Cardputer you need to change the Flash size to 8MB and the Partition Scheme to 8M with spiffs (3MB APP/1.5MB SPIFFS) or space error may occur.
It's your first time with arduino IDE or something not working correctly? You should check out video section or ask help on the discord !

Compile with arduino-cli

If you prefer the command line over the Arduino IDE:

Replace COMXX with your actual serial port.

----------------------------------------------------------

ESP32 Rig Slave

You can use any ESP32 as slave to collect SSID for wigle and sniff EAPOL

By using 14 ESP32 devices, you can monitor all 14 Wi-Fi channels on the 2.4GHz band simultaneously without channel hopping. The Cardputer uses GPS to link each received SSID to a CSV file compatible with Wigle.

This slave 代码 is designed to run on any ESP32 and use it as a slave for wardriving in combination with the wardriving master mode on Cardputer.
Each ESP32 collects SSIDs of nearby access points (APs) on a specific channel or can hop between configured channels.
You can add multiple ESP32 devices to improve the accuracy and strength of the scan. Devices with external antennas can enhance performance for wardriving.

Tested on:

AtomS3: Buy here

AtomS3 Lite: Buy here

ESP32-C3 (with external antenna): Buy here (Be carefull to select sets WITH antenna)

WEMOS D1 Mini: Buy here

ESP32 C5: Buy here

Features:

Multi-Device Support: Add any number of ESP32 devices to increase AP detection and impro.

Channel Hopping: Configure the ESP32 to scan on a specific channel or hop between selected channels.

Better Signal Strength: ESP32 devices with external antennas provide impro capture for long-range wardriving.

Master-Sla: Use in combination with the Cardputer in wardriving master mode to aggregate and monitor data from multiple ESP32 slaves.

GPS Integration: The Cardputer witg GPS link SSID data with geographic coordinates and generate Wigle-compatible CS.

How it Works:

1. Deploy one or more ESP32 devices in slave mode.
2. Each device scans and captures SSID information on designated channels.
3. The data is sent to the Evil, which aggregates it and reduces missed APs while improving o scan accuracy and signal strength.

Hardware Requirements:

Evil with v1.3.0

ESP32 devices (e.g., AtomS3, AtomS3 Lite, ESP32-C3, WEMOS D1 Mini)

External antenna (optional, for enhanced performance)

Here an assembly with 8 esp32-c3 connected in parallel and which scans 1,3,6,9,11,13 in static mode and in hopping for 2 others on 2,4,5,7 and 8,10,12,14 :
<di="center">
<img src=" width="300" /> <img src=" width="300" />
</div>

Acknowledgements

for the deauther bypass and for the fantastic work that is really inspiring.

@e for the concept of pwnagotchi and pwngrid.

for the wifi-hash-monster.

for the Wall Of Flipper.

for help and Bruce code.

for the help and Bruce code too.

for the Marauder.

Sasquach for creating video content about the project.

@Sam X Plogs for creating video content about the project.

for the fantastic work on M5dial.

for the work on the code.

@geo-tp for the work on the sd-card to usb.

for the incredible work of reverse ingeneriing of ESL tag. (You should definitely check the blog if you like hardware).

for porting ESLtagtinker on the flipper.

for the documentation on the rig build.

and to all Beta-testers on the discord :

[]</br>

[]</br>

[]</br>

[]</br>

[]</br>

[]</br>

[]</br>

[]</br>

[]</br>

[]</br>

----------------------------------------------------------

License

MIT License

Copyright (c) 2023 7h30th3r0n3

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The abo notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

项目信息

开发语言：C++

Star 数：2700

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Evil-M5Project is an innovative 工具 developed for ethical hacking and exploration of WiFi networks. It's compatible with Cardputer, Atoms3, Fire, core2. You can scan, monitor, and interact with WiFi networks in a controlled environment. This project is designed for educational purposes, aiding in understanding 网络 security and vulnerabilities展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。