
ESPectre - Bewegungserkennungssystem basierend auf Wi-Fi-Spektralanalyse (CSI), mit Home-Assistant-Integration.
Verwandle einen ESP32 in einen privaten, lokalen Wi-Fi-Bewegungssensor.
Wenn sich jemand durch einen Raum bewegt, verändert er die Art und Weise, wie sich Wi-Fi-Signale in diesem Raum ausbreiten. ESPectre liest diese Veränderungen aus und meldet Bewegungen in Echtzeit. Keine Kamera, kein Mikrofon, kein Wearable und keine dedizierte Radar-Hardware: nur ein unterstützter ESP32 und das Wi-Fi-Netzwerk, das bereits im Raum vorhanden ist.
ESPectre ist eine Open-Source-Plattform, die flashfertige Firmware, ein einbettbares C++-SDK, eine Arduino-Bibliothek, eine MicroPython-Implementierung, Browser-Tools, eine Host-CLI, einen offenen Datensatz, offene Modellgewichte und den Forschungs-Workflow zum Erstellen und Validieren der Detektoren zusammenführt.
Im Browser flashen · Die Live-Tools ansehen · Die Dokumentation lesen · Das SDK erkunden
Nutze ESPectre, um Licht oder ein Display einzuschalten, wenn jemand hereinkommt, die Heizung anzupassen, wenn ein Raum genutzt wird, oder eine Warnung zu senden, wenn es Bewegung an einem Ort gibt, an dem sich niemand aufhalten sollte. Es funktioniert mit Home Assistant (über ESPHome oder MQTT), erscheint als standardmäßiger Matter-Anwesenheitssensor, bietet eine lokale HTTP-API und kann mit dem C++-SDK oder einem Arduino-ESP32-Sketch in deine eigene ESP32-Firmware integriert werden.
Alles läuft auf dem Gerät: Es misst den Wi-Fi-Kanal (Channel State Information, kurz CSI) und meldet Bewegung sowie einen Bewegungswert. Nichts muss in die Cloud übertragen werden. Ein Board deckt einen Bereich ab, plane also ein Board pro Raum.
ESPectre erkennt Veränderungen in der Funkumgebung. Es identifiziert keine Personen, zählt sie nicht, beweist nicht, dass ein Raum leer ist, und ersetzt kein sicherheitszertifiziertes Sicherheits-, Medizin- oder Notfallsystem.
| Pfad | Am besten geeignet für | Hier starten |
|---|---|---|
| Native | Standalone-Sensoren, MQTT-Integrationen, einschließlich Home Assistant MQTT Discovery, und benutzerdefinierte Anwendungen | Native frontend |
| ESPHome | Home-Assistant-Nutzer, die native Entitäten, ESPHome-Provisionierung und Device-Builder-Updates wünschen | ESPHome frontend |
| Matter | Matter-Controller mit Unterstützung für Anwesenheitssensoren; getestet mit Google Home, Apple Home und Home Assistant | Matter frontend |
| Micro-ESPectre | Leichtgewichtige Sensorik in MicroPython mit lokalem, schreibgeschütztem Direct-HTTP-Monitoring | Micro-ESPectre README |
Der schnellste Weg erfordert nur einen Browser. Verwende Chrome 151 oder neuer für Desktop; Edge kann flashen, aber Device settings und Monitor funktionieren darin möglicherweise nicht.
Um deine Geräte im Netzwerk zu finden, verwende Find devices in den Browser-Tools oder ./espectre devices. Siehe die Discovery-Referenz für Anforderungen und Einschränkungen.

Matter-Status: Pairing, Belegungsaktualisierungen und Automatisierungen sind mit Google Home, Apple Home und Home Assistant getestet. Amazon Alexa und Samsung SmartThings sind noch nicht getestet. Google Home benötigt eine einmalige Developer Console-Einrichtung. Siehe Matter-Controller-Kompatibilität für die aktuelle Matrix.
Um aus diesem Repository zu bauen und zu flashen, beginne mit der Einrichtungsanleitung. Um alle verfügbaren Befehle anzuzeigen, führe aus:
./espectre --help