Skip to content

About

A wireless LED mood light and passive network security monitor built on the Seeed Studio XIAO ESP32 platform. The device runs a local web server over its own WiFi access point, giving you full control over lighting effects from any phone or laptop. In the background it continuously watches for WiFi deauthentication attacks and BlE.

Resources

Stars

34 stars

Watchers

0 watching

Forks

Repository files navigation

Skid Detector

A hacker's nightlight. An ESP32, a XIAO RGB Matrix, and a local web UI for lighting and passive wireless awareness.

Skid Detector pixel-art matrix emblem

Web flasher | Valleytech firmware flashers | Gitea | GitHub

Version 2.1.0

Shared detection rules and defaults across the hardware profiles: channel survey, deauth confirmation across repeated sweeps, Bluetooth pairing identity changes, and Axon presence lighting. The S2 profile supports Wi-Fi only.

  • One codebase for XIAO ESP32-S3, C3, C6 and C5; wired ESP32 and S2 profiles.
  • Soft two-minute color cycle at startup. Solid, two-color transition, rainbow wave, breathe, comet, twinkle and warm-white modes, plus plasma, aurora, fire, ocean, confetti, ripples, lava, color rain, scanner and kaleidoscope. Strobe, Dim & brighten, Chase and Color tiles bring the total to 22 modes.
  • Independent motion speed and color cycle, six palettes, reverse direction, ten presets and an animated preview. Adjustable fade/strobe cycle, minimum brightness and strobe on-time. See nightlight controls.
  • Saved brightness, saturation, colors, animation speed and matrix current budget.
  • Per-detection pattern, colors, brightness, duration, cooldown, confidence threshold and optional buzzer. Strong Axon candidates default to police lights. Axon lights continue until 15 seconds without qualifying sightings. Deauth floods flash red ten times; BLE floods flash blue ten times, followed by separate 30-second cooldowns. Continued flood evidence can repeat the alert afterward.
  • Sustained deauth floods, Bluetooth pairing spam and strong Axon matches alert by default. Trackers, Ring and all other device families are opt-in in Settings.
  • Dragon Detector signatures for Axon, Flipper, Pineapple, Flock, Meta, Pwnagotchi, Nyanbox, HaleHound, Biscuit, SmartTag, Find Hub, Tile, acoustic sensors, Ring, camera/ALPR vendors, Remote ID and serial-module indicators.
  • Sustained deauthentication/disassociation detection with duplicate filtering, per-BSSID windows and a conservative minimum threshold.
  • Pairing-payload burst detection instead of treating every crowded BLE room as spam.
  • Offline web UI, bounded recent-device list, alert history, health telemetry, settings import/export and five-minute alert silence.

Names, services and addresses can be spoofed. No passive detector can guarantee that every alert is an attack or every device is found. See detection details.

Hardware

Board profile Matrix DIN Optional buzzer Radios used
XIAO ESP32-S3 D0 / GPIO1 D1 / GPIO2 2.4 GHz Wi-Fi, BLE
XIAO ESP32-C3 D0 / GPIO2 D1 / GPIO3 2.4 GHz Wi-Fi, BLE
XIAO ESP32-C6 D0 / GPIO0 D1 / GPIO1 2.4 GHz Wi-Fi, BLE
XIAO ESP32-C5 D0 / GPIO1 D1 / GPIO0 2.4 GHz Wi-Fi, BLE
ESP32 DevKit, external wiring GPIO4 GPIO5 2.4 GHz Wi-Fi, BLE
ESP32-S2 Saola, external wiring GPIO4 GPIO5 Wi-Fi only

Requires the Seeed 6 x 10 RGB Matrix for XIAO (60 WS2812 LEDs) and at least 4 MB flash. H2 has no Wi-Fi and is unsupported. C5 5 GHz monitoring is not implemented. Generic boards must match the documented pin mapping and flash/USB configuration; a chip name alone is not a board profile.

Build and physical verification are separate in VALIDATION.md. See HARDWARE.md for power and buzzer wiring.

Install and connect

  1. Open the web flasher in desktop Chrome or Edge using HTTPS. Select the exact board profile.
  2. Connect a USB data cable, close serial monitors and select Connect & install. Installing replaces previous firmware. Keep a backup if it matters.
  3. Join SkidDetector-xxxxxx, password 12345678.
  4. Choose stay connected / use without internet if your phone asks.
  5. Open http://192.168.4.1 in your browser. Use HTTP, not HTTPS. Wildcard DNS and captive-portal redirects help phones discover the setup page. Up to four clients can connect; no internet connection is required.

The first upgrade to 2.0.1 restores the quiet alert defaults and two-minute color cycle once. Later settings changes are saved normally across restarts. The 2.0.2 upgrade enables Bluetooth spam alerts once while retaining your chosen nightlight mode. The 2.1.0 upgrade enables channel survey and the new red/blue/persistent-Axon defaults once, keeping your nightlight and buzzer preferences. Later edits persist.

If the port does not connect, hold BOOT, tap RESET, release BOOT and retry. The AP password is shared; anyone who joins can control the device.

The default matrix budget is 500 mA, plus the ESP32's own consumption. Higher budgets need an adequate external 5 V supply. The software estimate is not a current sensor.

Radio behavior

Idle surveying is enabled by default and visits channels 1–11 for 350 ms each, holding up to eight seconds for burst confirmation. The first 30 seconds after boot and brief connection attempts keep the AP steady so the web UI remains reachable. Detection continues on the current channel. Choose a home channel in System; its change takes effect after clients disconnect with survey disabled. Connecting a phone stops hopping on the current channel. BLE scans continuously and passively with a 35 ms receive window every 120 ms. This keeps confirmation windows intact while sharing radio time.

The firmware does not send deauthentication, disassociation or spam payloads. Its local AP still sends ordinary Wi-Fi management traffic.

Build

python -m pip install platformio==6.2.0 esptool==5.4.0
pio run -e xiao_s3
pio run -e xiao_s3 -t upload --upload-port YOUR_PORT

Other environments: xiao_c3, xiao_c6, xiao_c5, esp32, esp32_s2. The platform and libraries are pinned. The application needs no PSRAM allocation.

pio run -e xiao_s3 -e xiao_c3 -e xiao_c6 -e xiao_c5 -e esp32 -e esp32_s2
python tools/package_release.py
python -m pip install Markdown==3.10.2
python tools/package_guides.py

Commit source changes before package_guides.py: its ZIP archives HEAD.

This produces merged binaries, per-board manifests and SHA-256 checksums in flasher/. Serve that directory over HTTPS. web/ is the offline device UI; tools/embed.py compresses it into flash-resident assets.

Native tests: python tools/test_native.py (a C/C++ compiler, or the Python ziglang package, is required). Browser tests need Node.js and Playwright: node tests/ui_test.cjs (installed Edge, or PLAYWRIGHT_CHANNEL=chrome). Use PLAYWRIGHT_ENGINE=webkit for the WebKit run. With a device connected, python tests/captive_portal_test.py checks Android/Apple discovery responses.

Source and credits

src/ contains radio, lights and HTTP code. include/dragon_detection.h carries Dragon Detector's parser. Original .ino sketches remain historical source; they are not the version 2 entry points. Their README is archived in docs/.

By Your Pal Kal / Valleytech Solutions. Thanks to Seeed, Espressif, Adafruit, NimBLE-Arduino, ArduinoJson and ESP Web Tools.

Original and version 2 application code are MIT licensed. Third-party components retain their own licenses. See NOTICE.md and LICENSE.

About

A wireless LED mood light and passive network security monitor built on the Seeed Studio XIAO ESP32 platform. The device runs a local web server over its own WiFi access point, giving you full control over lighting effects from any phone or laptop. In the background it continuously watches for WiFi deauthentication attacks and BlE.

Resources

Stars

34 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages