Pre-fight

Public open-source M5Stack firmware repository for WiFi security testing, SD dashboard control, and captive portal management.

About

Pre-fight is a public fork of the original Evil-M5Project, refocused as a community repository for M5Stack offensive security tooling and educational experimentation.

This repository includes:

• firmware for M5Stack devices and M5Cardputer
• web dashboard features for SD card health and file browsing
• captive portal and Wi-Fi monitoring tools
• companion Android app code
• utilities for building and flashing

Disclaimer: Use this project only for legal, ethical, and authorized testing. Do not deploy on networks you do not own or have explicit permission to test.

Features

• SD card status dashboard and file browser
• Captive portal setup and monitoring
• Wi-Fi scan / probe detection
• Credential capture / logging
• Remote web interface for device control
• Support for multiple M5Stack boards and firmware variants

Supported Hardware

• M5Stack Cardputer (recommended)
• M5Stack Core2
• M5Stack Core3
• M5AtomS3
• M5Stack CoreS3
• M5Stick series (limited support)

Repository Contents

• Evil-Stick-Beta.ino – main firmware with SD dashboard and monitor status pages
• Evil-M5Core2-1-5-1.ino, Evil-M5Core3-1-1-9.ino, Evil-Cardputer-v1-5-2.ino – additional firmware variants
• android-companion-app/ – Android companion app source
• utilities/ – helper scripts and build prerequisites
• SD-Card-File/ – example SD files and payload assets
• slave/ – slave device firmware and auxiliary payloads

Getting Started

1. Prepare the SD card

1. Format an SD card as FAT32.
2. Copy the SD-Card-File/ contents into a folder named evil at the SD card root.
3. Insert the SD card into your device.

2. Flash firmware

Option A: Use M5Burner

1. Download M5Burner from the M5Stack Download Center.
2. Connect your M5Stack device.
3. Select the firmware file and flash it.

Option B: Compile locally

1. Open the Arduino IDE or PlatformIO.
2. Install board support for ESP32 and M5Stack devices.
3. Install required libraries:
   • Adafruit_NeoPixel
   • ArduinoJson
   • ESPping
   • IniFile
   • M5GFX
   • M5Unified
   • TinyGPSPlus
   • esp8266audio
4. Set the baud rate to 115200.
5. Disable PSRAM if required by the target board.
6. Upload the firmware to your device.

Usage

• Boot the device and use the built-in web server to access the dashboard.
• Open the monitor status page to see Wi-Fi and SD card health information.
• Use the SD browser to inspect and edit files on the SD card.

License

This repository is released under the MIT License. See the LICENSE file for details.

Notes

• This project is intended for research, learning, and authorized testing only.
• Do not use against networks or systems where you do not have permission.
• Always follow local laws and regulations.

Integration Paths

• Wigle / wardriving export is implemented in firmware and utilities:
  • Evil-Cardputer-v1-5-2.ino
  • Evil-M5Core2-1-5-1.ino
  • Evil-M5Core3-1-1-9.ino
  • Evil-CYD-Beta.ino
  • utilities/WigleOpenFinder/
  • utilities/wardriving/
• ESP-NOW messaging support appears in firmware and slave builds:
  • Evil-Stick-Beta.ino
  • Evil-Cardputer-v1-5-2.ino
  • Evil-M5Core2-1-5-1.ino
  • slave/C5-Slave/
  • slave/slave_unified_C3.ino
• Radar and CSI-style UI features are present in:
  • Evil-Cardputer-v1-5-2.ino
  • Evil-M5Core2-1-5-1.ino

Feature Navigation

• Open the built-in web server after boot to access the dashboard.
• Use the monitor status page for Wi-Fi and SD card metrics.
• Use the SD browser page to inspect SD files and folders.
• For Wigle / wardriving export, open the relevant firmware wardriving menu and save logs in WigleWifi-1.4 CSV format.
• For ESP-NOW support, check the firmware menu items labeled ESPNOW or ESP-NOW in the target build.
• For radar / CSI-style visual features, use the firmware display mode or menu option named radar or CSI.

---

Created as a public repository: https://github.com/stackzac22/Pre-fight