https://github.com/matiaspalmac/everything-imu
Cross-platform SlimeVR IMU bridge. Connects Nintendo and Sony controllers to SlimeVR, turning them into full-body tracking devices.
https://github.com/matiaspalmac/everything-imu
dualsense fbt full-body-tracking imu joycon psmove rust slimevr tauri vr
Last synced: 26 days ago
JSON representation
Cross-platform SlimeVR IMU bridge. Connects Nintendo and Sony controllers to SlimeVR, turning them into full-body tracking devices.
- Host: GitHub
- URL: https://github.com/matiaspalmac/everything-imu
- Owner: matiaspalmac
- License: mit
- Created: 2026-05-09T19:45:19.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-24T05:38:04.000Z (26 days ago)
- Last Synced: 2026-05-24T06:36:55.811Z (26 days ago)
- Topics: dualsense, fbt, full-body-tracking, imu, joycon, psmove, rust, slimevr, tauri, vr
- Language: Rust
- Size: 559 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-MIT
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
everything-imu
Cross-platform SlimeVR IMU bridge for game controllers
`everything-imu` is a native bridge that turns Nintendo and Sony game controllers
into full-body trackers for **SlimeVR-Server**. Plug a controller into your PC,
strap it on, and it shows up in SlimeVR as a regular tracker — no extra hardware,
no firmware flashing.
The bridge reads the controller's built-in IMU at its native sample rate, runs a
sensor fusion filter (VQF or Madgwick) in Rust, and forwards the resulting
quaternion to SlimeVR-Server over UDP using the official protocol.
> **Heads-up:** beta. Core fusion + protocol pipeline are stable and validated
> on hardware; the UI, settings persistence, and bundle packaging are still
> iterating. Expect rough edges and please file issues with reproduction
> steps + the logs from the **Logs** tab.
## Features
- **9 controller families** supported across USB · BT Classic · BLE · TCP.
- **VQF / Madgwick / BasicVQF** fusion, switchable per-device.
- **Magnetometer calibration wizard** for Joy-Con 2 and PS Move ZCM1 (sphere
fit + coverage meter).
- **Reset Yaw / Reset Full / Reset Mounting** from the UI, system tray, global
hotkey, or on-device gesture.
- **VRChat OSC → rumble bridge** with per-rule gain, threshold, pulse mode,
and a per-device haptic calibration wizard (floor / gain mapping).
- **UDP-forwarded haptic targets** — register `host:port` endpoints as virtual
rumble devices for remote setups.
- **Linux udev installer** — one-click hidraw access for Joy-Con / DualSense /
PSMove without sudo.
- **Auto-update at startup** (GitHub Releases), with optional crash reporting
via Sentry. Both opt-in, both off by default.
- **Live diagnostics** — per-tracker rate panels, bridge latency, raw IMU
charts on the Debug page, circular battery rings, signal meter.
## Why this exists
SlimeVR-Server already supports full-body tracking with dedicated SlimeVR
hardware. This project plugs the *bring-your-own-IMU* gap: most homes have
controllers with high-quality IMUs sitting in a drawer, and they make great
secondary trackers (waist, knees, feet) when you're trying SlimeVR for the
first time and don't want to commit to buying nodes yet.
We **deliberately do not reimplement SlimeVR-Server features** (skeletal model,
SteamVR driver, calibration UI, etc.). everything-imu is the *bridge layer*
only.
## Supported devices
| Device | Transport | Native rate | Mag | Status |
|--------|-----------|------------:|:---:|--------|
| Joy-Con (L/R) | USB · BT Classic | 200 Hz | ✗ | hardware-validated |
| Switch Pro Controller | USB · BT Classic | 200 Hz | ✗ | hardware-validated |
| Joy-Con 2 / Pro 2 / NSO GC2 | BLE only | 62 Hz | ✓ | hardware-validated |
| DualSense (PS5) | USB · BT | 250 Hz | ✗ | hardware-validated |
| DualSense Edge | USB · BT | 250 Hz | ✗ | needs hardware |
| DualShock 4 (PS4) | USB | 250 Hz | ✗ | hardware-validated |
| PS Move ZCM1 | USB · BT | 175 Hz | ✓ | hardware-validated |
| PS Move ZCM2 | USB · BT | 175 Hz | ✗ | hardware-validated |
| Wii Remote | TCP forwarder (`127.0.0.1:9909`) | 100 Hz | ✗ | hardware-validated |
Deep-dive on each: [DEVICES.md](DEVICES.md).
## Install
Grab the latest installer from the
[**Releases**](https://github.com/matiaspalmac/everything-imu/releases/latest)
page:
- **Windows**: `everything-imu__x64-setup.exe`
- **Linux (Debian/Ubuntu)**: `everything-imu__amd64.deb`
- **Linux (any)**: `everything-imu__amd64.AppImage`
Or build from source — see [Building from source](#building-from-source) below.
## Quickstart
1. **Install SlimeVR-Server** and leave it running. The default UDP port is `6969`.
2. **Run everything-imu**. The status bar at the bottom will read `Live` once a
handshake with the server completes.
3. **Plug or pair a supported controller**. It appears in the *Devices* tab; a
tracker for it shows up automatically in SlimeVR-Server.
4. **Mount the controller** to your body (waist, knee, ankle, etc.) and assign it
in SlimeVR-Server's *Body Proportions* flow.
5. **Reset orientation**: `R` (yaw) / `Shift+R` (full) from the global hotkeys,
or click *Reset Yaw* / *Reset Full* / *Reset Mounting* on the device card.
On controllers without a magnetometer (Joy-Con 1, DualSense, DualShock 4,
Wii Remote) yaw drifts on body rotation — re-yaw facing forward, or use
Reset Mounting right after strapping the tracker. Some devices accept
on-device gestures — see [DEVICES.md](DEVICES.md).
### Global hotkeys
| Shortcut | Action |
|----------|--------|
| `Ctrl+K` | Command palette |
| `Ctrl+F` | Global search |
| `Ctrl+Enter` | Cinema mode (immersive overlay) |
| `Ctrl+Shift+B` | Kill-switch the bridge (pause emission) |
| `R` / `Shift+R` | Broadcast yaw / full reset |
Mounting reset is per-device — click *Reset Mounting* on the device card or
the tracker detail page.
## Building from source
### Prerequisites
- **Rust** stable (1.79+ recommended)
- **Node.js** 22+ and **pnpm** 10
- **Windows**: WebView2 (preinstalled on Windows 11)
- **Linux**: `libwebkit2gtk-4.1-dev`, `libgtk-3-dev`, `libsoup-3.0-dev`,
`librsvg2-dev`, `libayatana-appindicator3-dev`, `libxdo-dev`, `libssl-dev`,
`libudev-dev`, `patchelf`
### Commands
```bash
git clone https://github.com/matiaspalmac/everything-imu.git
cd everything-imu
pnpm install # JS deps
pnpm tauri dev # dev: live-reload UI + Rust backend
pnpm tauri build # release bundle (MSI on Windows, AppImage on Linux)
# Backend-only iteration:
cargo test --workspace # unit + integration tests
cargo run -p headless-cli # headless bridge for debugging
```
The `everything-imu-app` binary is the full Tauri shell; `headless-cli` is a
no-UI driver useful for tracing protocol-level issues.
## Documentation
| File | Purpose |
|------|---------|
| [ARCHITECTURE.md](ARCHITECTURE.md) | Crate graph + responsibilities |
| [DEVICES.md](DEVICES.md) | Per-device IMU, transport, calibration |
| [PROTOCOL.md](PROTOCOL.md) | SlimeVR UDP wire format notes |
| [CONTRIBUTING.md](CONTRIBUTING.md) | Dev workflow, style, PR rules |
| [SECURITY.md](SECURITY.md) | Reporting vulnerabilities |
| [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) | Community ground rules |
## Stack
- **Core**: Rust, `tokio`, `hidapi`, `btleplug`, `nalgebra`
- **Math & fusion**: VQF (Laidig 2023), Madgwick, BasicVQF
- **Haptics**: `rosc` OSC listener, per-device rumble drivers
- **Persistence**: SQLite via `rusqlite`
- **Desktop shell**: Tauri 2 + tauri-specta (typed IPC)
- **Frontend**: React 19, TypeScript, Vite, TailwindCSS 4, Zustand 5,
react-three-fiber
## License
[MIT](LICENSE-MIT). Contributions are accepted under the same license.