WibbleWobbleVR - oneup03/VRto3D GitHub Wiki

WibbleWobble Setup and Configuration

  • Using WibbleWobble is at your own risk to your monitor/emitter/glasses. It works well but is unofficial
  • WibbleWobble works with 3DVision, Open3DOLED, and several DIY hardware solutions
  • These instructions cover 3DVision Hardware setup, but will hopefully be useful for others as well
  • Visit the WibbleWobble Discord for help and support

Switching From VRto3D (+WibbleWobbleReshade) to WibbleWobbleVR

  • You cannot run both of these virtual HMDs at the same time
  • If using WibbleWobbleReshade, rename dxgi.dll in your Steam\steamapps\common\SteamVR\bin\win64 folder
  • Open SteamVR prior to installing WibbleWobbleVR
  • On the SteamVR Status window, select Hamburger Icon->Settings
  • Go to the Startup / Shutdown tab
  • Select Manage Add-Ons
  • Turn vrto3d Off
  • If going back to VRto3D, reverse these steps and turn WibbleWobbleVR Off

Initial WibbleWobble Setup

  1. Download and unzip the latest release: Releases Here
  2. Register WibbleWobble:
    In Windows Explorer, right-click WibbleWobbleClient/Register.bat and select Run as administrator.
  3. Disable Desktop Scaling: Disable desktop scaling in Windows settings. WibbleWobble and some games are not DPI aware, and scaling can cause window size issues. (For example, Assetto Corsa.)

SteamVR Setup

  • Open Steam and install SteamVR if not already installed.
  • Navigate to the WibbleWobbleVR folder and Run Install.bat to register the path of WibbleWobbleVR with SteamVR; you probably don't need to run as administrator.
  • Launch Steam VR
  • Press SHIFT + / to toggle the focus on the overlay and then ALT + TAB to the SteamVR widget.
  • Room Setup
    • Click on the hamburger icon top left of the SteamVR widget and select Room Setup
    • Select STANDING ONLY
    • For ESTABLISH TRACKING it should say Headset Ready, click NEXT
    • For Calibrate your space. click CALIBRATE CENTER and wait; then click NEXT
    • For Locate the floor. you can set this to the distance that your head is from the floor (Recommended to use 100cm) or leave it at 0, then click CALIBRATE FLOOR and wait; then click NEXT
    • Click DONE
  • SteamVR Recommended Settings
    • Click on the hamburger icon top left of the SteamVR widget and select Settings
    • Select Show Advanced Settings
    • On the General Tab
      • Render Resolution to Custom (Auto applies x1.25 or x1.5 your WibbleWobbleVR resolution)
      • Notifications Off
      • Always on Top Off
      • Pause VR Off
      • Home Off
    • On the Dashboard tab
      • Consider turning everything Off
      • Present Non-VR Apps on Theater Screen Upon Launch Off
    • On the Video tab
      • Advanced Supersample Filtering Off
      • Per-Application Video Settings (When a VR game/mod is already running)
        • Ignore Almost everything
        • If you experience bad latency in-game, try toggling Use Legacy Reprojection Mode to On
    • On the OpenXR tab
      • Make sure Current OpenXR Runtime is SteamVR
      • Disable OpenXR API Layers if you have any
    • Close the SteamVR Status window to completely exit out of things
  • Download the latest CRU Release and save it to your WibbleWobble folder
  • Run CRU.exe and grant it admin
    • Take note of your monitor's EDID (first 7 characters in the dropdown list)
    • Exit CRU
  • Download the latest NvTimingsEd Release and save it to your WibbleWobble folder
  • Run NvTimingsEd.exe and grant it admin
    • From the drop down list, select your monitor's EDID (AUS_27B1 for Asus PG278QR for example)
    • Choose your target refresh rate / framerate you want to run 3D at
    • Click Edit but don't change anything
    • Copy the nearest integer refresh rate for WibbleWobble's Sync Rate HZ
    • Copy the X value for WibbleWobble's Open Delay Microseconds
    • Copy the Y value for WibbleWobble's Open Duration Microseconds
    • Copy the W value for WibbleWobble's W
  • Open Nvidia Control Panel
    • Under Manage 3D Settings tab:
      • Set Low Latency Mode to Ultra
      • Set Max Frame Rate to match your target refresh rate
      • Set Power Management Mode to Prefer Maximum Performance
      • Set Vertical Sync to Use the 3D application setting
    • Under Set up G-Sync tab, uncheck Enable G-Sync and click Apply
    • Under Set up stereoscopic 3D tab, uncheck Enable stereoscopic 3D and click Apply
    • Activate LightBoost using one of these 3 options:
      • Monitor OSD has LightBoost option:
        • Under the Change Resolution tab, set your target Refresh Rate and click Apply
        • Activate LightBoost in the monitor OSD
      • NVidia Custom Resolution:
        • Open the Change Resolution tab
        • Select Customize
        • Check Enable resolutions not exposed by the display and click Create Custom Resolution
        • The Horizontal Pixels and Vertical Lines should be the same as your monitor's native resolution
        • Set the Refresh Rate (Hz) to the same Refresh Rate as NvTimingsEd (nearest integer)
        • Change Timing Standard to Manual
        • Increase the Vertical Total Pixels value by +5 and click Test
        • If the Test is successful (Your monitor should switch to LightBoost mode), click Yes and then OK
        • Select your new Custom Resolution and corresponding Refresh Rate and click Apply and Yes
      • ToastyX Strobelight:
        • May cause monitor Out of Range errors: can try to fix using its hotkeys, but may need a second monitor or perhaps safe mode to fix
        • Try following the instructions on the release page
  • Launch SteamVR
  • WibbleWobbleVR Settings
    • Press Shift + END to start WibbleWobble
    • Press Shift + END again to bring up the WibbleWobble menu
    • You have to press Enter key to apply any WibbleWobble setting
    • Press Shift + / to (un)focus WibbleWobble (necessary to see anything else on desktop)
    • Select Client Config
      • Set Window Size X/Y for your Fullscreen Resolution
      • Set Source Format to Side By Side Half
      • Set Reprojection to Disabled
      • Set DWM to Enabled
      • Set Elevate Process Priority to Enabled
      • DO NOT MODIFY Other Settings unless you are using something other than 3DVision
      • Click Save and X to close the window
    • Select VR Config
      • Set Resolution X to your desired horizontal render resolution (1920 recommended)
      • Set Resolution Y to your desired vertical render resolution (1080 recommended)
      • Set Display Frequency to the closest integer value of your Refresh Rate
      • Set FoV Horizontal to your desired FoV (90.0 recommended)
      • Leave World Scale at 1.0, it does nothing
      • Set IPD to 0.6 (This is Depth; Higher=Stronger)
      • Set Focal Length to 4.0 (This is Convergence; Lower=Stronger)
      • Click Save and X to close the window
    • Select Emitter Config
      • Set Sync Rate HZ to match your nearest integer refresh rate from NvTimingsEd
        • If you experience eye flips, try setting this to the exact decimal value instead
      • Click Nvidia Config
        • Select Enabled
        • Set Open Delay Microseconds to the NvTimingsEd X value
        • Set Open Duration Microseconds to the NvTimingsEd Y value
        • Set W to the NvTimingsEd W value
        • Click Save and X to close the window
      • Click Save and X to close the window
    • Press Shift + END to close the WibbleWobble menu
    • Use Shift + / to focus/unfocus WibbleWobble when starting VR games/mods
    • Use Shift + , to flip eye output
  • Close the SteamVR Status window to completely exit out of things

Playing a Game

  1. Start the Game:
    Launch the game in VR mode
  2. Confirm entering VR (NOT ALL GAMES) If you see a black screen chances are the game is waiting for you to confirm that it should enter VR.
    • SHIFT + / will unfocus the WibbleWobble window allowing you to ALT + TAB to find the window for the game and click the required buttons.
    • SHIFT + / again will re-focus the WibbleWobble window once you have confirmed entering VR mode.
    • Sometimes it's enough to just focus the game window with ALT + TAB and hit enter to confirm the option.
  3. Configure or Play:
    • Once launched, you can adjust WibbleWobble’s settings or begin playing.
    • VR specific settings such as resolution, fov, etc.. can be changed inside VR Config.
      • FoV & Focal Length may not update properly when a game is running and require you to restart the game or mod
    • Changes to Resolution require a SteamVR restart; this is an OpenVR limitation.
    • Some games prevent the automatic focus change to the WibbleWobbleUI; if you press SHIFT + END and nothing happens or the UI draws and you can't control it; focus the WibbleWobble window with ALT + TAB to regain control.
  4. Maintain Focus on the Game Window:
    The game window should remain in focus. If the WibbleWobble window is in focus when the WibbleWobble UI is closed, ALT + TAB until the game window is in focus.
  5. ReCenter the view: Place your head at the centre of the play space and press "SHIFT + ." to recenter tracking. You need to do this every time you run WibbleWobble to center the tracking. If the reprojection behaves strangely such as scaling irregularly this means your head is in the wrong position when recentering. You may need to move your head a little closer or further away than expected when recentering; this takes some practice.
  6. OPTIONALLY: Toggle the overlay focus: Press "SHIFT + /" to toggle the focus on the overlay. You can do this to be able to use the mouse accurately within the game. There is a mouse cursor fix coming to remove the need to do this.
  7. Don't close the WibbleWobble window WibbleWobble will currently not recover if you close the WibbleWobble window. You must restart the game if you do this. Use the SHIFT + / key to toggle the overlay focus if you need to get around the desktop.

Troubleshooting

  • If you experience ghosting, try turning on your monitor's Lightboost or Ultra Low Motion Blur or ULMB feature. You may have to enable 3DVision in Nvidia Control Panel for this setting to be available
  • If your 3D Emitter doesn't activate, try the following:
    • Unplug/replug the emitter
    • Toggle 3DVision On/Off
    • Restart SteamVR
  • If you are getting too much wobbling, try the following:
    • Toggle VSync off or on in-game
    • Close all other applications
    • Toggling GSync On/Off
    • Toggling 3DVision On/Off
    • Or try rebooting
  • If WibbleWobble settings are really messed up, delete your %APPDATA%\..\LocalLow\PHARTGAMES\WibbleWobble folder
  • To uninstall the driver completely, navigate to the WibbleWobbleVR folder and Run Uninstall.bat; you may need to run as administrator.