Skip to content

colonelpanichacks/oui-spy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 

Repository files navigation

OUI-SPY

OUI-SPY

ESP32-S3 based BLE detection system with integrated buzzer and power management.

This board has sick PCB art. Available on Tindie and colonelpanic.tech - Ready-to-use, no additional components required.

Firmware Options

Choose the firmware that matches your use case:

Multi-target BLE device scanner with OUI filtering

  • Detects multiple devices simultaneously by MAC address or manufacturer OUI
  • Web-based configuration portal for target management
  • Smart cooldown system prevents alert spam
  • Audio feedback with different beep patterns for new vs. re-detected devices
  • Persistent configuration storage
  • Good for general surveillance and device monitoring

Use Cases: Security monitoring, device inventory, general BLE scanning


Precision proximity tracker for radio direction finding

  • Single target MAC address tracking with real-time RSSI analysis
  • Variable proximity beeping based on signal strength (closer = faster beeps)
  • Optimized for directional antenna usage and triangulation
  • Aggressive scanning parameters for maximum sensitivity
  • Clean audio feedback system for field operations
  • Good for foxhunting competitions and asset recovery

Use Cases: Radio direction finding, asset tracking, security device location, RF analysis


Advanced Unitree robot exploitation system with web interface

  • BLE-based command injection exploits for Unitree Go2, G1, H1, and B2 robots
  • AutoPwn automation with 7-step exploitation and bulletproof error handling
  • Real-time BLE scanning with signal strength indicators and target management
  • Custom command injection with SSID/password injection methods
  • Comprehensive web interface with operations logging and system monitoring
  • AES-CFB128 encryption implementation for Unitree's crypto protocol
  • Based on original research by Bin4ry and d0splash

Use Cases: Security research, authorized penetration testing, educational robotics security assessment


Advanced Flock Safety surveillance camera detection system

  • Multi-method detection using WiFi promiscuous mode and BLE scanning
  • Real-time monitoring with comprehensive JSON output and audio alerts
  • MAC address filtering and SSID pattern matching for surveillance devices
  • Channel hopping across all 13 WiFi channels for maximum coverage
  • Smart audio alert system with boot sequence, detection alerts, and heartbeat
  • Built-in datasets from deflock.me for enhanced detection accuracy

Use Cases: Surveillance detection, privacy protection, security assessment, research and education


Drone RemoteID detection and real-time mapping system

  • Dual-protocol scanning: WiFi promiscuous mode + BLE for OpenDroneID (ASTM F3411)
  • Real-time GPS coordinate extraction from drone broadcasts (location, altitude, speed, heading)
  • Operator/pilot location tracking and identification
  • JSON serial output for mesh-mapper.py visualization integration
  • Thread-safe audio alerts: 3 quick beeps on detection, heartbeat every 5 seconds
  • Multi-drone tracking: Monitor up to 8 drones simultaneously
  • Non-blocking buzzer implementation with dedicated FreeRTOS task

Use Cases: Drone detection, airspace monitoring, RemoteID compliance verification, counter-UAS awareness


3D Prints

Enhance your OUI-SPY with custom 3D printed cases and accessories:

by out0fstep

  • Protective case with external antenna hole for enhanced RF performance
  • Secure fit for OUI-SPY board with proper ventilation
  • Compatible with external directional antennas for foxhunting applications

by out0fstep

  • Compact travel case for portable OUI-SPY operations
  • Protective design for field use and storage
  • Easy access to controls and indicators

by out0fstep

  • Portable keychain case for everyday carry
  • Compact design for discreet operations
  • Easy access to all controls and indicators

by out0fstep

by Nitekry D Paul

  • SMA connector spacer for external antenna mounting
  • Ensures proper antenna positioning and signal optimization
  • Compatible with various SMA antenna configurations

by out0fstep

  • Universal yagi Grip for foxhunting
  • picitinny rail compatibility

Hardware Specifications

  • MCU: ESP32-S3 dual-core processor
  • Connectivity: WiFi 802.11n, Bluetooth 5.0, BLE
  • Audio: Integrated buzzer with PWM control
  • Power: USB-C powered with efficient power management
  • Antenna: Built-in antenna with option for external directional antenna
  • Form Factor: Compact PCB design optimized for portable use

Quick Start

  1. Purchase your OUI-SPY board from Tindie or colonelpanic.tech
  2. Choose firmware from the repositories above
  3. Flash firmware using PlatformIO or Arduino IDE
  4. Power on and connect to WiFi AP snoopuntothem
  5. Configure targets via web portal at http://192.168.4.1

Technical Features

Advanced BLE Scanning

  • Maximum aggressive scanning parameters for optimal detection
  • Dual-core processing for concurrent web interface and scanning
  • Real-time RSSI analysis and signal strength reporting
  • Support for both active and passive scanning modes

Privacy & Security

  • MAC address randomization for stealth operation
  • No traceable hardware fingerprints
  • Secure web configuration with timeout protection
  • Local processing - no cloud dependencies

Audio System

  • Multiple beep patterns for different alert types
  • Variable frequency proximity indication
  • Clean startup and ready signals
  • Non-overlapping audio sequencing

OUI Reference

Looking for manufacturer prefixes? Check the full list here: OUI List (ouis.md)

Gotta catch 'em all — contribute your findings!

If you need to verify an OUI, use one of these lookup tools:


Choose your firmware above and start detecting.

License

Open source project. Hardware available commercially on Tindie and colonelpanic.tech.

PCBWAY Production

I'm proud to partner with PCBWay for my PCB production needs. They've done an excellent job manufacturing the boards for my Oui-Spy runs, delivering high-quality PCBs with consistent results and reliable turnaround times. Their attention to detail and professional service has made them my go-to choice for bringing my hardware designs to life.

About

unified firmware links for oui-spy board

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published