ESPectre Turns Your Wi-Fi Router Into a Ghost-Detecting Motion Sensor

GitHub June 2026
⭐ 7762📈 +934
Source: GitHubArchive: June 2026
ESPectre transforms any standard Wi-Fi router into a passive motion detector by analyzing subtle changes in Channel State Information (CSI). No cameras, no PIR sensors—just signal reflections and a $5 ESP32 board, integrated natively with Home Assistant.

ESPectre, an open-source project by developer francescopace, has rapidly gained traction on GitHub with over 7,700 stars and a single-day spike of 934 stars. The system leverages Wi-Fi Channel State Information (CSI)—the fine-grained amplitude and phase data of subcarriers in an OFDM signal—to detect human movement in indoor environments. Unlike traditional motion sensors that rely on infrared heat (PIR) or active radar (mmWave), ESPectre is entirely passive: it listens to existing Wi-Fi signals from a standard router and uses an ESP32 microcontroller to capture CSI packets. The software then applies signal processing and machine learning to classify whether motion is occurring, and it exposes a binary motion sensor entity to Home Assistant via MQTT or native API. The appeal is obvious: for under $20 in hardware, homeowners can add motion detection to any room without drilling holes or worrying about privacy violations from cameras. The trade-off, however, is sensitivity to environmental noise, multipath interference, and the need for a stable Wi-Fi link. ESPectre is not yet a drop-in replacement for a $10 PIR sensor, but it opens the door to a new class of software-defined sensing that could reshape how we think about occupancy detection in smart homes.

Technical Deep Dive

ESPectre’s core innovation lies in exploiting Wi-Fi Channel State Information (CSI), a data structure that describes how a wireless signal propagates between a transmitter and receiver. While most Wi-Fi applications only care about the received signal strength indicator (RSSI)—a single scalar value—CSI provides a complex matrix of amplitude and phase for each OFDM subcarrier (typically 52 to 114 subcarriers in 802.11n/ac). When a human moves through the environment, they alter the multipath reflections of these subcarriers, creating distinctive patterns in the CSI time series.

Architecture: The system runs on an ESP32 microcontroller flashed with custom firmware that puts the Wi-Fi chip into monitor mode. It sniffs 802.11 packets from a nearby access point (typically a 2.4 GHz router) and extracts CSI data from the preamble of data packets or beacon frames. The raw CSI is then processed on-device using a lightweight signal pipeline:

1. Noise filtering: A moving average or Savitzky-Golay filter removes high-frequency noise from the amplitude of each subcarrier.
2. Dimensionality reduction: Principal Component Analysis (PCA) or a simple variance-based selection picks the most sensitive subcarriers.
3. Motion detection: A threshold-based detector compares the short-term variance of the filtered CSI against a baseline. If the variance exceeds a configurable threshold, motion is declared.

More advanced versions of the firmware (available in the project’s GitHub repository) incorporate a lightweight convolutional neural network (CNN) trained on labeled CSI samples to distinguish between human motion, pet movement, and environmental noise like fan blades or curtains. The model is quantized to INT8 to fit in the ESP32’s 520KB SRAM.

Performance Benchmarks: The project’s documentation and community benchmarks provide the following data:

| Metric | ESPectre (Default) | ESPectre (ML-enhanced) | Commercial PIR (e.g., Philips Hue) | mmWave Radar (e.g., Aqara FP2) |
|---|---|---|---|---|
| Detection Range | 5-8 meters | 5-8 meters | 6-10 meters | 6-12 meters |
| Detection Latency | 200-500 ms | 300-800 ms | 1-2 seconds | 100-300 ms |
| False Positive Rate (quiet room) | 5-10% | 2-5% | <1% | <1% |
| False Negative Rate (walking) | 10-15% | 5-8% | <1% | <1% |
| Power Consumption | 0.5W (ESP32) | 0.6W (ESP32) | 0.1W (battery) | 0.5-1W (USB) |
| Hardware Cost | $5-10 | $5-10 | $15-25 | $30-50 |
| Privacy Level | Excellent (no image/audio) | Excellent | Good (no image) | Good (no image) |

Data Takeaway: ESPectre’s detection accuracy lags behind dedicated hardware sensors, especially in false positive/negative rates. However, its cost and privacy advantages are unmatched. The ML-enhanced version narrows the gap significantly, suggesting that further algorithmic improvements could make it viable for non-critical applications like lighting automation or presence-based HVAC control.

Relevant GitHub Repositories:
- francescopace/ESPectre (⭐7,762): The main project with firmware, Home Assistant integration guide, and 3D-printable enclosure designs.
- esp32-csi-tool (⭐1,200+): A lower-level library for raw CSI capture on ESP32, used as a dependency by ESPectre.
- OpenWrt-CSI (⭐800+): An alternative approach that runs CSI analysis on OpenWrt routers directly, without an external ESP32.

Key Players & Case Studies

ESPectre sits at the intersection of three communities: open-source hardware enthusiasts, Home Assistant ecosystem developers, and academic researchers in Wi-Fi sensing. The primary player is francescopace, an independent developer who has built a polished integration that lowers the barrier to entry for hobbyists. However, the underlying technology has been explored by several academic groups:

- University of Washington’s Wi-Fi Sensing Group (e.g., Wi-Vi, WiTrack): Pioneered through-wall motion detection using CSI, but required expensive USRP radios. ESPectre democratizes this by running on commodity hardware.
- Xiaomi’s Aqara FP2: A commercial mmWave presence sensor that costs $40-50 and offers zone-based occupancy detection. It is ESPectre’s closest competitor in the privacy-conscious smart home market, but it requires dedicated hardware and a wired USB connection.
- Tuya’s Wi-Fi Motion Sensor: A low-cost ($10) device that uses RSSI-based motion detection. It is far less accurate than CSI-based approaches and suffers from frequent false triggers.

Comparison of Passive Motion Detection Approaches:

| Solution | Technology | Cost | Privacy | Accuracy | Home Assistant Native |
|---|---|---|---|---|---|
| ESPectre | Wi-Fi CSI | $5-10 | Excellent | Medium | Yes (MQTT/API) |
| Aqara FP2 | mmWave Radar | $40-50 | Good | High | Yes (Zigbee) |
| Philips Hue Motion Sensor | PIR | $20-25 | Good | High | No (Zigbee bridge) |
| Tuya RSSI Sensor | RSSI | $10 | Excellent | Low | Yes (Wi-Fi) |
| Camera-based (e.g., D-Link) | Computer Vision | $30-80 | Poor | Very High | Partial |

Data Takeaway: ESPectre occupies a unique niche: it is the only option that combines excellent privacy, near-zero hardware cost, and native Home Assistant integration. Its accuracy is the main trade-off, but for use cases like “turn on lights when someone enters the room” or “detect if a room is occupied for energy saving,” medium accuracy is often sufficient.

Industry Impact & Market Dynamics

The smart home sensor market was valued at approximately $12 billion in 2025 and is projected to grow at 15% CAGR through 2030. The dominant technologies—PIR and mmWave—are mature but face two headwinds: privacy concerns (especially in bedrooms and bathrooms) and battery life (PIR sensors need battery changes every 6-12 months). ESPectre addresses both by being completely passive (no emissions) and drawing power from USB (no batteries).

Adoption Curve: ESPectre is currently a hobbyist project, but its rapid GitHub growth (934 stars in one day) signals strong interest. If the project can achieve 90%+ detection accuracy in controlled environments, it could attract commercial interest from smart home companies like Shelly, Sonoff, or even Amazon (which owns Eero routers and could integrate CSI sensing into their mesh Wi-Fi).

Market Data:

| Year | ESPectre GitHub Stars | Estimated Active Users | Commercial CSI Products |
|---|---|---|---|
| 2024 (Dec) | 1,200 | ~500 | 0 |
| 2025 (Jun) | 7,762 | ~3,000 | 1 (ESPectre-based kits on AliExpress) |
| 2026 (Projected) | 20,000+ | ~15,000 | 3-5 |

Data Takeaway: The growth trajectory suggests that Wi-Fi CSI sensing is moving from academic curiosity to practical home use. If the accuracy gap can be closed through better ML models (e.g., transformer-based CSI analysis), this could become a standard feature in Wi-Fi chipsets, much like how Bluetooth RSSI is now used for proximity detection.

Risks, Limitations & Open Questions

1. Wi-Fi Stability: ESPectre requires a stable link between the router and the ESP32. If the router changes channels, reboots, or experiences interference from neighboring networks (common in apartment buildings), the CSI baseline shifts and false positives spike. The project currently lacks automatic recalibration.

2. Multipath Interference: In rooms with metal furniture, mirrors, or multiple walls, the CSI signal becomes chaotic. Detection range drops to 3-4 meters, and accuracy plummets. This limits its usefulness in kitchens or home offices with metal desks.

3. Scalability: Each ESP32 can monitor one room. A 3-bedroom house would need 4-5 ESP32 units, each requiring a USB power source and a Wi-Fi connection. This adds wiring complexity that a single PIR sensor on a 9V battery avoids.

4. Security: The ESP32 is a low-power microcontroller with limited security features. If an attacker gains physical access, they could inject malicious CSI data to spoof motion events (e.g., trigger a false alarm). The project does not implement encryption or authentication for its MQTT messages.

5. Regulatory: Using Wi-Fi in monitor mode to capture CSI could be interpreted as passive packet sniffing. While the project only captures preamble data (not payload), some jurisdictions may consider this a violation of wiretapping laws. The developer has not addressed this legal gray area.

AINews Verdict & Predictions

ESPectre is not a revolution—it is an evolution. The technology of Wi-Fi CSI sensing has been known for a decade; what francescopace has done is package it into a product that a Home Assistant user can set up in 30 minutes. That is a meaningful contribution, but the project faces a classic open-source dilemma: to achieve the reliability needed for mainstream adoption, it needs dedicated hardware (e.g., a custom PCB with a better RF front-end) and continuous ML model updates, which are hard to sustain without funding.

Predictions:

1. By Q4 2026, at least one major smart home vendor (likely Shelly or Sonoff) will release a commercial CSI-based motion sensor priced at $15-20, undercutting mmWave sensors and cannibalizing their own PIR product lines.

2. By 2027, Qualcomm or Broadcom will add a CSI-based motion detection API to their Wi-Fi chipset SDKs, allowing routers to act as motion sensors without an external ESP32. This will make ESPectre obsolete for new installations but validate the approach.

3. ESPectre itself will either be acquired by a company like Home Assistant (Nabu Casa) or forked into a commercial product. The project’s current license (MIT) allows commercial use, and we expect to see “ESPectre Pro” kits on Amazon within 12 months.

4. The biggest impact will not be in home security, but in elderly care. Fall detection using Wi-Fi CSI is an active research area, and ESPectre’s privacy-preserving nature makes it ideal for nursing homes where cameras are forbidden. We predict a dedicated “ESPectre Care” variant optimized for fall detection by mid-2026.

What to watch: The accuracy of the ML-enhanced version on the latest commit. If the developer achieves <2% false positive rate in a real-world test, the project will cross the chasm from hobbyist toy to viable product.

More from GitHub

UntitledCloudStream is not just another media player; it's a paradigm shift in how users access and consume video content on AndUntitledThe GitHub repository 'AutonomousRepo' (yoavlax/autonomousrepo) has garnered attention for its bold claim: every line ofUntitledThe GitHub Copilot SDK, now available as an open-source project on GitHub with over 9,300 stars on its first day, providOpen source hub2432 indexed articles from GitHub

Archive

June 2026577 published articles

Further Reading

Home Assistant's Local-First Revolution: How Open Source is Redefining Smart Home PrivacyHome Assistant has emerged as the definitive platform for privacy-conscious smart home enthusiasts, rejecting the cloud-CloudStream: The Open-Source Android App Reshaping How We Stream MediaCloudStream, an open-source Android app with nearly 10,000 GitHub stars, is revolutionizing mobile media streaming throuAutonomousRepo: When AI Writes Every Line of Code – A New Frontier or a Dead End?A GitHub repository claims to have been built entirely by an AI agent, from the first commit to the latest feature. AutoGitHub Copilot SDK Unlocks AI Coding Beyond the Editor: What Developers Need to KnowGitHub has released the Copilot SDK, a multi-platform toolkit that lets developers embed Copilot Agent capabilities dire

常见问题

GitHub 热点“ESPectre Turns Your Wi-Fi Router Into a Ghost-Detecting Motion Sensor”主要讲了什么?

ESPectre, an open-source project by developer francescopace, has rapidly gained traction on GitHub with over 7,700 stars and a single-day spike of 934 stars. The system leverages W…

这个 GitHub 项目在“ESPectre vs Aqara FP2 accuracy comparison”上为什么会引发关注?

ESPectre’s core innovation lies in exploiting Wi-Fi Channel State Information (CSI), a data structure that describes how a wireless signal propagates between a transmitter and receiver. While most Wi-Fi applications only…

从“ESPectre Home Assistant MQTT setup guide”看,这个 GitHub 项目的热度表现如何?

当前相关 GitHub 项目总星标约为 7762,近一日增长约为 934,这说明它在开源社区具有较强讨论度和扩散能力。