Skip to content

Repository files navigation

M5_CRYSTAL

A multifunctional firmware for pentesting and everyday use. Built for M5Stack devices, all in a clean and stable codebase focused on simplicity and extensibility.

Firmware preview

Features

  • Wi-Fi: scanner, deauth, WPA bruteforce, handshake capture, evil twin, evil portal, WPS PBC, web server, channel analyzer, weather, time sync, wifi info, wifi connect, password save
  • Bluetooth: BLE Scan, BAD BLE, sniffer, device finder, gyro mouse, gyro keyboard, presenter, phone camera shutter, mouse jiggler
  • NFC: read and write UID, tag info (PN532 module)
  • IR: read signal, save signal to littleFS, send signal, TV-B-Gone
  • USB: BAD USB, mouse jiggler, air mouse, keyboard, mass storage mode
  • Files: create, edit, delete, rename and files in sd card and littleFS.
  • UART terminal: recieving and sending text. baud rate and pins settings
  • Settings: language, time, timezone, rotation, colors, brightness, status bar, startup sound, keyboard gyro, screen dimming, web server FS mode
  • Other: clock, flashlight, battery, level tool, sound meter, system info
  • 12 Languages: English, French, German, Portuguese, Turkish, Italian, Spanish, Indonesian, Russian, Ukrainian, Polish, Romanian
  • Devices: M5StickCPlus2, M5StickS3, Cardputer-ADV (Cardputer v1.1)
  • Modules: PN532, SD, IR reciever.

Installation

You can install the firmware from m5burner or flash it yourself (by downloading the binary file first or compiling it yourself). All compilation methods are described in detail in the documentation.

Documentation

Simple, stable, customizable, and extensible

This firmware's structure follows the KISS principle. The code is extremely simple and structured. All functions use my wrappers, allowing you to quickly add new "programs" while focusing on the functionality itself, without wasting time interacting with the interface.

Firmware architecture

You can easily add a new function using the documentation and by looking on already created funcs in functions/ folder.

⭐ Support

If you liked this project — please give it a star. It takes 2 seconds and helps the project grow, reach more people, and stay motivated.

Have a bug, idea, or question? Open an Issue. Want to contribute code? See CONTRIBUTING.md.

🚀 Upcoming Features (2nd iteration)

  • BAD USB feature
  • USB and BLE mouse jiggler
  • USB mouse and keyboard
  • Evil portal / Evil twin
  • Handshake capture
  • PMKID capture
  • web server in custom directory
  • icons in menu
  • notifications in UI
  • RFID features
  • directory support for file browser
  • WiFi channel analyzer
  • pixie dust attack
  • WPS bruteforce
  • advanced wifi info feature
  • CSI radar
  • M5 Stick S3 support
  • M5 Stick S3 built in IR support
  • CH9329 module support
  • NRF24L01 module suport
  • CC1101 module support
  • UART terminal
  • extended support for serial commands
  • copying and moving files between LFS and SD
  • creating and deleting directories
  • NFC emulator
  • test migration to Arduino 3.X

About

A multifunctional firmware for pentesting and everyday use. Built for M5Stack devices.

Topics

Resources

Contributing

Stars

83 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages