ESPectre

Guides

Learn the basics, build a working sensor, then tune it or explore how ESPectre fits into a larger product.

Official guides

Guides maintained by the ESPectre team.

Furnished room with fixed blue Wi-Fi paths and an amber path reflected by a walking person before reaching an ESP32
THEORY

How Wi-Fi sensing detects movement

Packets, CSI, multipath, and how movement changes the radio channel.

3 min read
Six supported ESP32 boards arranged in a row
HARDWARE

Choose your hardware

How to choose a compact board, antenna, and power supply.

2 min read
An ESP32 board connected to a laptop for browser flashing
SETUP

Flash and set up your device

Install from the browser, connect to Wi-Fi, and add the device to Home Assistant.

7 min read
Top-down room showing a router, an ESP32, a walking person, and reflected Wi-Fi paths
INSTALLATION

Place your ESPectre sensor

Distance, antenna orientation, obstacles, and a repeatable room test.

5 min read
An ESP32 sending sensing data to the ESPectre dashboard in Home Assistant
HOME ASSISTANT

Build your Home Assistant dashboard

Build a dashboard for ESPHome or MQTT devices, and add the optional traffic generator app.

8 min read
An ESP32 branching one Wi-Fi signal into short and deep processing paths
DETECTION

Choose your detection profile

Compare resource use, detection quality, and startup, and pick the right one.

4 min read
A Python snake mascot perched on an Espressif board connected to a laptop displaying CSI traces
DEVELOPMENT

Run ESPectre on MicroPython

Use the CSI support ESPectre added to MicroPython, and detect motion right on the device.

3 min read
An ESP32 connected to a laptop showing signal diagnostics, with a magnifying glass inspecting a waveform
TROUBLESHOOTING

Troubleshoot your sensor

Fix calibration that never finishes, false or missed motion, and devices you cannot reach.

5 min read