UDCAP Control

A Tauri 2 + Svelte 5 control panel for UDCAP (Udexreal) VR gloves on Linux — for both Monado and SteamVR. It supervises udcap-server, shows live glove status, runs guided calibration, tunes per-finger curl/splay and the per-hand alignment offsets, remaps the controller inputs, pairs gloves to their receivers, and installs the SteamVR driver — all over a shared-memory contract (udcap_shm.h).

AI usage: This project was developed with AI assistance (Anthropic's Claude), under human direction, testing, and review.

Run (user)

If you plan on using Monado, you must install my custom fork. This is because I use protocols that are not yet implemented in the official Monado repo. Installation procedures (only a few commands) available there.

For SteamVR users, nothing special, the app should install its driver on first launch.

Run (dev)

You must clone udcap-server in a folder next to udcap-control, as this repo is the client app only.

pnpm install
./sync-server.sh        # build + bundle the udcap-server binary (once)
./sync-steamvr.sh       # build + bundle the SteamVR driver (once, for SteamVR mode)
pnpm tauri dev

Troubleshooting

My gloves are not detected in Monado!

• Did you install the custom fork? Are your trackers paired and connected to Monado? You should see your trackers and "UDCAP" gloves in the list if you use Envision.

My gloves are not detected in SteamVR!

• Did you launch udcap-control before SteamVR? If not, try restarting SteamVR.

My hands positions/rotations are wrong!

• You can tweak them in the "Space" tab, which is saved on app restart.

Monado & SteamVR

The same backend (udcap-server + the shared memory) drives both runtimes, only the consumer differs. Pick one with the Runtime mode toggle on the dashboard; it swaps the Space-tab alignment offsets to that runtime's set (their pose conventions differ, so they tune separately).

• Monado — the native drv_udcap driver (built into your Monado).
• SteamVR — a bundled OpenVR driver the app installs with one click (dashboard in SteamVR mode → Install; Reinstall/Remove live in Settings). It registers the gloves as Index Knuckles, and auto-updates itself when you update the app.

Screens

• Status — runtime-mode toggle, SteamVR driver install (first run), per-glove battery / FPS / firmware, live buttons + trigger/grip + joystick, VR-ready indicator, permissions setup.
• Controls — live controller readout + per-hand vibration test; a visual hand-schema button map (remap A/B/System/Stick and force trigger/grip from any glove input); and analog trigger/grip config — which finger drives each axis, with dual-range min/max sliders.
• Calibrate — guided fist → together → spread (both hands), via the GUI button or the glove power button, with audio cues.
• Fingers — per-finger curl-range tuning (live reading + draggable handles), global curl strength, and finger splay.
• Space — per-hand position/rotation alignment offsets (per runtime mode), tracker presets, tracker-serial mapping; live.
• Devices — pair gloves to their wireless receivers (guided, one-at-a-time flow) and switch each receiver's RF channel to dodge interference.
• Settings — server override, device permissions, SteamVR driver management, about + credits.

Frameless custom titlebar; dark Material-You design.

Architecture

udcap-control (Tauri app)
  ├─ Rust: spawn/supervise udcap-server, mmap shm (seqlock reads), commands,
  │        one-click SteamVR-driver install (+ auto-update)
  └─ Svelte 5 (custom MD3): polls backend ~10Hz, renders + writes offsets/maps/commands
        │ shared memory (/dev/shm/udcap_hands)
        ▼
   udcap-server  →  reads gloves, publishes state, calibration + haptics + reconnection
        │ (same shm — two consumers, pick one at runtime)
        ├─ drv_udcap (Monado)     →  OpenXR Index controllers
        └─ driver_udcap (SteamVR) →  OpenVR Index/Knuckles controllers (+ skeletal fingers)

The udcap-server binary and the SteamVR driver_udcap are built from the UdCap-Community-HandDriver-Core repo and bundled into the app (system libs only) via sync-server.sh / sync-steamvr.sh.

Packaging

pnpm tauri build produces deb / rpm / AppImage. Arch is covered by a PKGBUILD in packaging/arch/ (the AUR route) — see its README.

Credits

UDCAP glove decoding by the OldestNova team (Community Hand Driver Core, MIT); Valve OpenVR/SteamVR + the hand-skeleton sample; Monado (OpenXR runtime).