n0xa/m5stick-nemo logo

n0xa/m5stick-nemo

Free

M5 Stick C firmware for high-tech pranks and digital self defense

FreeFree tier
Type
Open Source

About n0xa/m5stick-nemo

NEMO is an open-source firmware for M5Stack ESP32 devices (primarily M5 Stick C) that bundles a variety of high-tech pranks, digital self-defense utilities, and learning tools. It includes BadUSB Hunter to detect malicious USB peripherals, wireless attack detection (BLE, Deauth, PineAP), TV-B-Gone infrared control, AppleJuice iOS Bluetooth spam, WiFi SSID spam and a captive portal for credential harvesting. Other features include a WiFi scanner, digital clock with RTC, and EEPROM-backed settings. Designed for education and experimentation, NEMO demonstrates what a small development kit can achieve with curiosity and effort.

Key Features

BadUSB Hunter (Cardputer & ADV models) - detects HID devices, suspicious USB cables, and multi-interface BadUSB peripherals
Wireless Attack Detection: BLE Hunter, Deauth Hunter, and PineAP Hunter for situational awareness
TV-B-Gone port to shut off infrared-controlled TVs and projectors
AppleJuice iOS Bluetooth device pairing spam
Bluetooth notification spamming for SwiftPair (Windows) and Android
WiFi Spam - funny SSIDs, Rickroll, and random SSID generation
WiFi NEMO Portal - captive portal that captures email credentials to SD card
WiFi SSID Scanner - displays 2.4 GHz networks with cloning capability
User-adjustable 24-hour digital clock backed by M5 Stick RTC
EEPROM-backed settings for rotation, brightness, dimming, and portal SSID

Pros & Cons

Pros
  • Open-source and completely free (MIT license)
  • Multi-functional: combines many prank and defense tools in one firmware
  • Runs on affordable M5Stack hardware (M5 Stick C, Cardputer, ADV)
  • Regular updates and active community (1.3k stars, 203 forks)
  • Educational: helps understand ESP32 capabilities and common attack vectors
Cons
  • Requires specific M5Stack ESP32 hardware (not compatible with generic ESP32 boards)
  • Some features (captive portal, spam) may be unethical or illegal without consent
  • Limited to 2.4 GHz WiFi; no 5 GHz support
  • Documentation is primarily on GitHub with some features still in development

Best For

Learning ESP32 development with Arduino IDEEducational demonstrations of wireless attacks and defensesField-testing unknown USB peripherals for safetyPranks and social engineering experimentsPersonal digital self-defense awareness

FAQ

What hardware is needed to run NEMO?
NEMO is designed for M5Stack ESP32 devices, primarily the M5 Stick C. The BadUSB Hunter feature requires the Cardputer or ADV models with USB-C OTG support.
Is NEMO free?
Yes, NEMO is open-source and free to use under the MIT license. You can download the firmware and modify it.
What can NEMO do?
NEMO includes multiple tools: BadUSB detection, wireless attack monitoring (BLE, Deauth, PineAP), TV remote control, Bluetooth spam, WiFi SSID spam, a captive portal for credential capture, WiFi scanning, a digital clock, and more.
Can I contribute to NEMO?
Yes, the project is open-source on GitHub with 299 commits and active development. Contributions are welcome.