Desktop and SteamVR controls, together in one Windows app.
Wrist menu · Floating panel · Bluetooth toys · OpenShock · PiShock · OSC / SPS · Friends Connect
Downloads · Getting started · Guides · Report an issue · Contribute
ShockWave is a native Windows application for supported Bluetooth toys and OpenShock or PiShock devices. Draw and loop patterns on the desktop or with the built-in SteamVR wrist menu and floating panel. Pair with a friend running ShockWave, or use the separate VRChat OSC / SPS integrations.
The SteamVR panel is included in the app. It needs no Unity project, avatar installation or avatar upload.
Current development preview: 0.8.1 — restored updates from older versions. Get the current complete Windows package from Releases. See verification and known limits before using hardware.
| Feature | How it works |
|---|---|
| Bluetooth toy controls | Discover supported Lovense toys, see individual functions and battery readings, and adjust Input, Sensitivity and Max %. |
| Integrated SteamVR controls | Open a compact wrist menu or a detailed floating panel. Use controller pointers, grip the side handles and resize with both hands. |
| Draw and play patterns | Select functions, draw curves, record and loop them through Toy control. Desktop and SteamVR share the same patterns and controls. |
| Shocker control | Use OpenShock or PiShock with individual limits, pause and cooldown. Shock requires two separate presses within three seconds. |
| VRChat and SPS | Shared automatic SPS controls, plug/socket discovery and optional manual body-map connections. |
| Direct app connections | Pair two ShockWave apps using a private code. Each receiver controls its own hardware and applies its own limits. |
| Test mode | Preview supported control paths without sending physical output. |
Shocker control, Connect and Update previews
These are software-test previews with simulated devices and empty connection codes. They illustrate the interface; they are not evidence of physical-device testing.
- Start SteamVR, then open ShockWave.
- In Settings → SteamVR panel, choose the hand and whether to open as Wrist or Panel. Save settings to remember your choice.
- Use the headset icon at the bottom left of Toy control or Shocker control to open the overlay. The icon beside it recenters the floating panel.
- In Wrist mode, bring the other controller near the wrist icon, freshly hold grip and pull upward to unfold the menu. Select a toy function, then point at the grid and hold trigger to draw. Drawing continues outside the grid until you release.
Expand drops the larger panel. Touch either side handle and hold grip to move it while the other hand uses its pointer. Grip both handles and pull apart or together to resize; the return icon brings it back to the wrist. Pull the wrist's top bar back to its anchor to close the menu. Closing the wrist menu keeps active patterns and already submitted shocks running; Stop ends continuous toy activity and cancels pending shock confirmation.
Settings include whole-overlay transparency, saved wrist placement and optional automatic opening when SteamVR is available. Read the SteamVR guide for controls and current limits.
Requirements: Windows 10 version 1809 or newer, or Windows 11, on an x64 PC. The VR overlay requires SteamVR and tracked controllers; it runs independently of avatar content. Bluetooth control requires a compatible Windows Bluetooth adapter and supported toy. OpenShock and PiShock require their own hardware and account credentials. The separate VRChat OSC / SPS features require VRChat with OSC enabled.
To install:
- Open Releases and read that version's notes.
- Download its Windows x64 package. For a portable ZIP, extract the whole archive and keep its folders together, then run
ShockWave.exe. - Open Settings and enable Test mode before trying the controls. Fresh settings currently start with Test mode off.
- Follow the guide for Bluetooth toys, OpenShock or PiShock.
- For VR, follow SteamVR setup. For another ShockWave user, follow Connect setup. Keep connection codes private; connecting authorizes the paired person's supported controls within your limits.
A visible toy or moving curve does not mean hardware output is enabled. Test mode deliberately blocks vibration and other device commands. To use hardware, turn off Settings → Debug → Test mode, save settings and confirm Live mode, then select a connected function and start a fresh draw. Each owner's Sensitivity and Max % still apply.
The current Bluetooth backend bundles Intiface Engine as a hidden child process; no separate Intiface or Lovense Remote application is required. The optional legacy Lovense DLL has separate vendor terms and is excluded from the public source and current portable package.
The older avatar panel remains optional for existing setups: Creator Companion listing · avatar installation guide. It is separate from the integrated SteamVR panel. The Windows app does not install avatar content or save Unity scenes.
Version 0.8.1 restores the direct update path from older releases. Its SteamVR files use directories recognized by the original updater. Use Check for updates → Update; the earlier 0.8.0 package required a manual download because it used new root-level paths. Your settings and credentials stay in the same user-data folder.
Update, directly below Settings, shows the installed version, checks for published releases and links to the new version on GitHub. A newer compatible release adds Update available beside the Toy panel heading; clicking it opens Update. The Update button downloads and verifies the package, uses the existing normal-close confirmation, installs it and restarts ShockWave.
Automatic update defaults off. When enabled, new releases download in the background and install on your next normal app close, without reopening the app. Cancelling a close warning keeps ShockWave running. Install the first complete updater-enabled package manually; subsequent newer stable releases can be offered in the app. See update setup and limits.
Settings, device limits, mappings and encrypted credentials use the existing %LOCALAPPDATA%\SzebsToys data folder, independently of the program folder. Keep this folder private. See the publication guide for packaging and release steps.
| Topic | Guide |
|---|---|
| Windows interface, OpenShock and settings | Windows app |
| PiShock accounts and devices | PiShock setup |
| Bluetooth setup, compatibility and limits | Local toys |
| Integrated wrist menu, floating panel and VR settings | SteamVR |
| Optional legacy avatar panel and Unity installation | Avatar panel |
| SPS discovery and body mappings | SPS |
| Pairing two apps and connection limitations | Connect |
| Standalone OSC bridge | Bridge |
| Current implementation and test evidence | Workstream status |
- Automated checks cover simulated devices, control limits, fresh-input rules, disconnect behavior and interface rendering. Physical Bluetooth response, stop timing and headset behavior still need model-specific verification.
- Six default SteamVR controller profiles are included. A live passive check verified pointer poses, triggers and grips on Oculus Touch; other headset/controller combinations still need physical testing.
- Direct app pairing has been exercised with two clients on one PC. Separate household/mobile networks still need testing. There is no TURN relay fallback; some networks cannot establish a direct connection.
- Stop cancels pending confirmation and continuous toy activity. A shocker command already accepted by its provider can continue for its bounded duration.
- Current Windows packages are unsigned. A clean-PC installation test remains pending.
- Use the relevant release notes and detailed status to distinguish implemented features, simulated checks and physical tests.
Install the .NET 8 SDK, Node.js 24.21.0 and PowerShell 7 on Windows x64. From the project root:
./overlay/build.ps1The build restores locked Node dependencies when needed, verifies/downloads the pinned Bluetooth engine, publishes the app and checks its hidden worker without a physical device. The default output is overlay/dist/shockwave/ShockWave.exe.
This developer build requires the .NET 8 Desktop Runtime on the machine that runs it. Use overlay/package-release.ps1 for a complete self-contained Windows ZIP with the updater ownership manifest. The older installer pipeline still needs alignment with the current Bluetooth and remote package; it is not the update payload.
Bug reports, documentation improvements and focused pull requests are welcome. Start with CONTRIBUTING.md, and use SECURITY.md for sensitive reports. Never upload credentials, invitation codes, personal configuration or private device identifiers.
ShockWave uses the ShockWave Source-Available Contribution License 1.0. It permits inspecting/building ShockWave and making changes to contribute fixes back to the official project. Publishing independent modified releases or reusing its code in unrelated projects requires separate permission. GitHub's own public-repository viewing/forking permissions and third-party licenses remain applicable.
ShockWave is source available under these contribution-only terms. Read the full license before using the source or contributing changes.
Third-party components retain their own licenses. See THIRD-PARTY.md, rendering notices and Bluetooth engine notices. ShockWave is an independent project; product names identify integrations and do not imply endorsement.