@kelnishi/satmouse
v0.17.1
Published
6DOF spatial input bridge — run with npx @kelnishi/satmouse
Readme
@kelnishi/satmouse
Run SatMouse — a 6DOF spatial input bridge that streams SpaceMouse, gamepad, and HID device data to web apps.
Install & Run
npx @kelnishi/satmouseDownloads the correct platform binary from GitHub Releases on first run.
What It Does
SatMouse bridges spatial input devices to web apps over WebSocket and WebTransport:
- Detects connected devices (SpaceMouse, gamepads, HID)
- Broadcasts
_wot._tcpvia mDNS for zero-config discovery - Streams 6DOF data at device rate (~60-120 Hz)
- Legacy compatibility on port 18944 (spacemouse-proxy protocol)
Ports
| Port | Protocol | Purpose | |---|---|---| | 18944 | WebSocket | Legacy spacemouse-proxy compat | | 18945 | HTTP + WebSocket | Thing Description, reference client, spatial stream | | 18946 | WebTransport | Low-latency HTTP/3 QUIC datagrams | | 18947 | HTTPS | Thing Description + client (for HTTPS pages) |
Platforms
| Platform | Status |
|---|---|
| macOS (Apple Silicon) | .app bundle with menu bar icon + Safari Web Extension |
| Windows (x64) | System tray icon with context menu (SatMouse.cmd) |
| Linux (x64) | systemd user service with install/uninstall scripts |
For Client Apps
Install the SDK to integrate spatial input into your app:
npm install @kelnishi/satmouse-clientSee @kelnishi/satmouse-client for API docs.
License
MIT — GitHub
