8000 GitHub - 7h30th3r0n3/Evil-M5Project: Evil-M5Project is an innovative tool developed for ethical testing 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 network security and vulnerabilities.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content
/ Evil-M5Project Public

Evil-M5Project is an innovative tool developed for ethical testing 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 network security and vulnerabilities.

7h30th3r0n3.fr/
1.1k stars 104 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

7h30th3r0n3/Evil-M5Project

BranchesTags

Repository files navigation

Evil-M5Project v1.4.1

Evil-M5Project is an innovative tool developed 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 environment. This project is designed for educational purposes, aiding in understanding network security and vulnerabilities.

Disclaimer: The creator of Evil-M5Core2 is not responsible for any misuse of this tool. 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 Evil-M5Core2 are designed to be used in a controlled environment and must be used in compliance with all applicable laws and regulations. Misuse or illegal use of this tool is strictly prohibited and not supported by the creator.

Evil-M5Family

☕️ Support This Project

If you find this project useful, consider supporting its development!

Support via M5Stack shop

Buy M5Stack product
using my affiliate link to help me keep building new tools 🛠️

AliExpress Logo

Buy anything on AliExpress
Just by using this link before searching, you're directly supporting the project 🙌

Every small click and donation keeps this open-source project alive ✨ just clicking can make a difference 😊


Join the Evil-M5 discord for help and updates 😉:

Join Discord

For More Information Check The Wiki !

For More Information Check The Wiki !

https://github.com/7h30th3r0n3/Evil-M5Project/wiki

Compatible Hardware

🧱 M5Stack Devices

Device Links to buy
Better one : M5Cardputer M5Stack / AliExpress
M5Stack Core2 M5Stack / AliExpress
M5Stack Fire M5Stack
M5Stack Core1 M5Stack
M5Stack AWS M5Stack
M5Stack CoreS3 M5Stack / AliExpress
M5Stack CoreS3 SE M5Stack
M5AtomS3 (GPS needed) M5Stack
↳ GPS Module M5Stack
LLM Module M5Stack / AliExpress

🧪 In Beta

Device Links
CYD2USB AliExpress
CYD1USB (No link yet)
M5Stick v1.1 AliExpress
M5Stick v2 AliExpress

📦 Required Extras

  • SD Card (FAT32, SDHC, max 16Go – 8Go is already enough)
  • GPS Module: M5Stack / DIY

Features may vary depending on the firmware/device you are using:

Feature Evil-Cardputer v1.4.1 Evil-M5Core2 1.3.9 Evil-M5Core3 1.1.9 Evil-AtomS3 v1.1.7 Evil-Face v1.0
WiFi Network Scanning ✅ ✅ ✅ ✅ ❌
Network Cloning ✅ ✅ ✅ ✅ ❌
Captive Portal Management ✅ ✅ ✅ ✅ ❌
Credential Handling ✅ ✅ ✅ ✅ ❌
Remote Web Server ✅ ✅ ✅ ✅ ❌
Probes Attack ✅ ✅ ✅ ✅ ❌
Sniffing probes ✅ ✅ ✅ ✅ ❌
Karma Attack ✅ ✅ ✅ ✅ ❌
Automated Karma Attack ✅ ✅ ✅ ✅ ✅
Karma Spear ✅ ✅ ✅ ❌ ❌
Bluetooth Serial Control ❌ ✅ ❌ ❌ ❌
Wardriving ✅ ✅ ✅ ✅ ❌
Wardriving Master ✅ ❌ ❌ ❌ ❌
Beacon Spam ✅ ✅ ✅ ✅ ❌
Deauther ✅ ✅ ❌ ❌ ❌
Auto Deauther ✅ ❌ ❌ ❌ ❌
Evil-Twin ✅ ❌ ❌ ❌ ❌
Handshake master ✅ ✅ ❌ ❌ ❌
Client Sniff ✅ ✅ ❌ ❌ ❌
Raw Sniffing ✅ ✅ ❌ ❌ ❌
Wi-Fi Channel Visualizer ✅ ✅ ❌ ❌ ❌
Client Sniff And Deauth ✅ ✅ ❌ ❌ ❌
EAPOL/Deauth detection ✅ ✅ ✅ (No EAPOL) ❌ ❌
Wall Of Flipper ✅ ✅ ✅ ❌ ❌
Send tesla code with RFunit ✅ ❌ ❌ ❌ ❌
Wi-Fi Channel Visualizer ✅ ✅ ❌ ❌ ❌
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 Starvation ✅ ✅ ❌ ❌ ❌
Rogue DHCP ✅ ✅ ❌ ❌ ❌
Switch DNS ✅ ✅ ❌ ❌ ❌
Network Hijacking ✅ ✅ ❌ ❌ ❌
Detect Printer ✅ ✅ ❌ ❌ ❌
File Print ✅ ✅ ❌ ❌ ❌
Check printer status ✅ ✅ ❌ ❌ ❌
HoneyPot ✅ (with Webhook) ✅ ❌ ❌ ❌
LLM Chat Stream ✅ ❌ ❌ ❌ ❌
EvilChatMesh ✅ ❌ ❌ ❌ ❌
SD on USB ✅ ❌ ❌ ❌ ❌
Responder ✅ ❌ ❌ ❌ ❌
Settings ✅ ✅ ✅ ✅ ❌

Installation

M5burner

  1. Connect your device to your computer.
  2. Download M5burner in UIFLOW FIRMWARE BURNING TOOL 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).
  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 code.
  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:
  4. Ensure the ESP32 and M5Stack board definitions are installed. Note: Errors occur with ESP32 version 3.0.0-alpha3 for no M5stack devices. Please use M5stack board with ESP32 version 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).
  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 !

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 code 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:

Features:

  • Multi-Device Support: Add any number of ESP32 devices to increase AP detection and improve coverage.
  • 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 improved signal capture for long-range wardriving.
  • Master-Slave Communication: 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 CSV files.

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 overall scan accu 8E11 racy 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 :

Acknowledgements

and to all Beta-testers on the discord :

  • [@KamiLocura]
  • [@Skedone]
  • [@toxiccpappii]
  • [@OarisKiller]
  • [@hosseios]
  • [@BrownNoise]
  • [@DAKKA]
  • [@KNAX]

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 above copyright 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.

About

Evil-M5Project is an innovative tool developed for ethical testing 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 network security and vulnerabilities.

7h30th3r0n3.fr/

Resources

Readme
Activity

Stars

1.1k stars

Watchers

48 watching

Forks

104 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 12

Languages
0