← all repositories
MaliosDark/wifi-3d-fusion

Turning WiFi Static Into 3D Human Skeletons

This project turns cheap WiFi hardware into a real-time 3D motion-capture sensor by extracting human pose from channel state information using deep learning.

1.6k stars Python Computer VisionDomain Apps
wifi-3d-fusion
Not currently ranked — collecting fresh signals.
star history

What it does

WiFi-3D-Fusion is a research pipeline that ingests WiFi Channel State Information — the fine-grained radio metrics usually ignored by your laptop — and runs them through a PyTorch-based detector to estimate 3D human pose and movement. It supports two hardware paths: an ESP32 broadcasting CSI over UDP, or a Linux USB WiFi adapter running Nexmon firmware in monitor mode. The system renders results live in an Open3D viewer or a web-based Three.js interface, and it can bridge its output into related research modules like Person-in-WiFi-3D (CVPR 2024) and NeRF².

The interesting bit

The clever part is treating multipath WiFi reflections as a free, always-on sensing modality rather than noise to filter out. By fusing these radio fingerprints with computer vision techniques, the project attempts to track multiple people and maintain identity across sessions (ReID) using nothing but the ambient signals already bouncing around the room.

Key highlights

  • Ingests CSI from either ESP32 UDP streams or Nexmon tcpdump captures, with a real-time movement detector sitting in between.
  • Claims continuous learning: the CNN-based detector supposedly adapts thresholds and retrains in the background based on detection confidence and user feedback.
  • Bundles bridges to external research code: Person-in-WiFi-3D for multi-person pose, NeRF² for neural radiance fields, and an RSSI volumetric mapper.
  • Ships with both an Open3D native viewer and a browser-based Three.js renderer with HUD overlays.
  • Explicitly tagged “Research Only,” which is honest given the specialized hardware and Linux-only stack.

Caveats

  • Requires specific, non-generic hardware: either an ESP32 flashed with CSI firmware or a Broadcom/Nexmon-compatible USB adapter in monitor mode, plus a Linux host.
  • The README notes its own architecture diagrams contain typos and are being revised, suggesting the documentation is still settling.
  • Claims around “continuous” and “automatic” model improvement are stated but lack technical detail on how feedback is collected or validated.

Verdict

Worth a look if you are a wireless-sensing researcher or a curious hacker with a spare ESP32 and a tolerance for radio-frequency tinkering. Skip it if you need a plug-and-play room monitor that runs on your existing Windows laptop.

Frequently asked

What is MaliosDark/wifi-3d-fusion?
This project turns cheap WiFi hardware into a real-time 3D motion-capture sensor by extracting human pose from channel state information using deep learning.
Is wifi-3d-fusion open source?
Yes — MaliosDark/wifi-3d-fusion is an open-source project tracked on heatdrop.
What language is wifi-3d-fusion written in?
MaliosDark/wifi-3d-fusion is primarily written in Python.
How popular is wifi-3d-fusion?
MaliosDark/wifi-3d-fusion has 1.6k stars on GitHub.
Where can I find wifi-3d-fusion?
MaliosDark/wifi-3d-fusion is on GitHub at https://github.com/MaliosDark/wifi-3d-fusion.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.