Skip to content

About

Run Google Earth VR on a standard Windows monitor using a virtual OpenVR headset and an Xbox or DualSense controller.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

10 Commits

Folders and files

Repository files navigation

DesktopEarthVR

DesktopEarthVR is an unofficial OpenVR virtual-device and controller compatibility tool for Windows 10/11 x64. It lets users without a physical VR headset view the SteamVR mirror on a normal monitor and control the Steam release of Google Earth VR with a gamepad.

DesktopEarthVR is not an official Google, Valve, Steam, or Google Earth VR project and is not endorsed by them. Users must install and license Steam, SteamVR, and Google Earth VR themselves. This project does not distribute or modify files from those products.

What it provides

  • A native Windows launcher with standalone and Steam %command% wrapper modes.
  • One virtual HMD and two virtual Vive controllers through an external OpenVR driver.
  • An SDL3 gamepad bridge using versioned Windows shared memory.
  • Idempotent driver registration, bounded startup waits, lifecycle cleanup, local logs, an installer, a portable package, and a documented rollback.

A normal monitor is not stereoscopic VR. It displays SteamVR's mirror view. Third-party OpenVR drivers can be affected by future SteamVR changes or conflict with other drivers; review the uninstall and recovery instructions before use. Alpha installers are not code-signed, so Windows SmartScreen may show an unknown-publisher warning. Verify SHA256SUMS.txt before running a package.

Platform and controller status

  • Primary platform: Windows 10/11 x64.
  • Recommended controller: Xbox-compatible gamepad.
  • Wired PS5 DualSense: experimental; the SDL mapping exists but physical acceptance testing is still pending.

Quick start

  1. Install Steam, SteamVR, and Google Earth VR through Steam.
  2. Install DesktopEarthVR-Setup-x64.exe or extract the portable ZIP.
  3. Connect an Xbox controller.
  4. Run DesktopEarthVRLauncher.exe and select Start Google Earth VR.

For direct Steam launching, copy this shape of launch option from the launcher:

"<install directory>\DesktopEarthVRLauncher.exe" --steam-wrap %command%

The wrapper executes Steam's original command with CreateProcessW; it does not launch App ID 348250 again and therefore does not recurse.

Architecture

Xbox / DualSense
       |
       v
DesktopEarthVRBridge.exe (SDL3)
       |
       v
Local shared memory
       |
       v
driver_deskearth.dll (OpenVR)
       |
       v
SteamVR -> Google Earth VR -> VR View on the monitor

The launcher validates and registers the driver, starts or reuses the Bridge, starts SteamVR when configured, waits for vrserver.exe and vrcompositor.exe, launches the game, and cleans up only the Bridge instance it created. It never forcibly closes a SteamVR instance that was already running.

Build and test

From PowerShell:

& .\scripts\build.ps1
& .\scripts\test.ps1
& .\scripts\package-release.ps1

Dependencies are pinned in DEPENDENCIES.lock. Downloaded dependencies, build trees, user logs, Steam data, absolute machine paths, and release outputs are excluded from Git.

Documentation

License and attribution

DesktopEarthVR source is MIT licensed. Required Valve OpenVR and SDL3 notices are preserved in THIRD_PARTY_NOTICES.txt and included in binary packages.

About

Run Google Earth VR on a standard Windows monitor using a virtual OpenVR headset and an Xbox or DualSense controller.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages