Detections
+ +No detections yet
+Start scanning with your Flock You device to see detections here
+
+
+**Professional surveillance camera detection for the Oui-Spy device available at [colonelpanic.tech](https://colonelpanic.tech)**
+
+## Overview
+
+Flock You is an advanced detection system designed to identify Flock Safety surveillance cameras and similar surveillance devices using multiple detection methodologies. Built for the Xiao ESP32 S3 microcontroller, it provides real-time monitoring with audio alerts and comprehensive JSON output.
## Features
-### Real-Time Detection Monitoring
-- **Live Updates**: Real-time detection display via WebSocket
-- **Detection Filtering**: Filter by detection method (WiFi, BLE, MAC, Device Name)
-- **Statistics Dashboard**: Overview of detection counts and types
-- **Detailed View**: Complete device information for each detection
+### Multi-Method Detection
+- **WiFi Promiscuous Mode**: Captures probe requests and beacon frames
+- **Bluetooth Low Energy (BLE) Scanning**: Monitors BLE advertisements
+- **MAC Address Filtering**: Detects devices by known MAC prefixes
+- **SSID Pattern Matching**: Identifies networks by specific names
+- **Device Name Pattern Matching**: Detects BLE devices by advertised names
-### GPS Integration
-- **GPS Dongle Support**: Connect USB GPS dongles for location tracking
-- **NMEA Parsing**: Automatic parsing of GPS coordinates
-- **Location Tagging**: Each detection can include GPS coordinates
-- **Satellite Information**: Display GPS fix quality and satellite count
+### Audio Alert System
+- **Boot Sequence**: 2 beeps (low pitch → high pitch) on startup
+- **Detection Alert**: 3 fast high-pitch beeps when device detected
+- **Heartbeat Pulse**: 2 beeps every 10 seconds while device remains in range
+- **Range Monitoring**: Automatic detection of device leaving range
-### Data Export
-- **CSV Export**: Download detection data in CSV format
-- **KML Export**: Generate Google Earth compatible KML files
-- **GPS Coordinates**: Include latitude, longitude, and altitude
-- **Timestamped Files**: Automatic filename generation with timestamps
+### Comprehensive Output
+- **JSON Detection Data**: Structured output with timestamps, RSSI, MAC addresses
+- **Real-time Web Dashboard**: Live monitoring at `http://localhost:5000`
+- **Serial Terminal**: Real-time device output in the web interface
+- **Detection History**: Persistent storage and export capabilities (CSV, KML)
+- **Device Information**: Full device details including signal strength and threat assessment
+- **Detection Method Tracking**: Identifies which detection method triggered the alert
+
+## Hardware Requirements
+
+### Option 1: Oui-Spy Device (Available at colonelpanic.tech)
+- **Microcontroller**: Xiao ESP32 S3
+- **Display**: 5-inch 1280x720 IPS TFT with multi-touch
+- **Wireless**: Dual WiFi/BLE scanning capabilities
+- **Audio**: Built-in buzzer system
+- **Connectivity**: USB-C for programming and power
+
+### Option 2: Standard Xiao ESP32 S3 Setup
+- **Microcontroller**: Xiao ESP32 S3 board
+- **Buzzer**: 3V buzzer connected to GPIO3 (D2)
+- **Power**: USB-C cable for programming and power
+
+### Wiring for Standard Setup
+```
+Xiao ESP32 S3 Buzzer
+GPIO3 (D2) ---> Positive (+)
+GND ---> Negative (-)
+```
## Installation
### Prerequisites
-- Python 3.8 or higher
-- USB GPS dongle (optional, for location tracking)
+- PlatformIO IDE or PlatformIO Core
+- Python 3.8+ (for web interface)
+- USB-C cable for programming
+- Oui-Spy device from [colonelpanic.tech](https://colonelpanic.tech)
-### Setup
-1. **Install dependencies**:
+### Setup Instructions
+1. **Clone the repository**:
```bash
+ git clone Start scanning with your Flock You device to see detections here
+