Gaia Sky VR#

Note

Gaia Sky VR is beta software. It works reasonably well, but you may encounter hiccups here and there..

Since 3.5.0

Gaia Sky VR is the VR version of Gaia Sky. It runs on multiple headsets and operating systems using the OpenXR API.

Our tests have been carried out with the Oculus Rift CV1 headset on Windows and the Valve Index on Windows and Linux. We also successfully tested it with the HP Reverb G2. Due to the system-agnostic nature of OpenXR, other VR HMD systems and controllers supporting OpenXR should also work fine.

Note

Gaia level-of-detail star catalogs don’t work very well in VR and may cause performance issues. We recommend using static star catalogs like DR3-tiny, DR3-weeny, Hipparcos or GCNS5.

Currently, the regular installation of Gaia Sky also includes the VR version.

System requirements#

The minimum system requirements for running Gaia Sky VR are roughly the following:

VR System

OpenXR-compatible VR system (HMD, VR controllers, trackers)

Operating system

Windows 10+ / Linux

CPU

Intel Core i5 4rd Generation or similar (4+ core)

GPU

VR-capable GPU (GTX 970+ strongly recommended)

Memory

8+ GB RAM

Hard drive

1 GB of free disk space (depends on datasets)

Set-up#

Essentially, you need an OpenXR runtime installed system-wide.

  1. Install runtime — Follow the provided vendor instructions and install the software PC application for your VR headset. This application provides the OpenXR runtime. This is the Oculus/Meta PC app for Meta headsets, or SteamVR for the HTC Vive/Pro and the Valve Index, for example.

  2. Set active OpenXR runtime — Set the runtime as the active OpenXR runtime. This typically is in the settings dialog of the vendor software. This step enables your particular OpenXR runtime to be discoverable by OpenXR-enabled applications like Gaia Sky VR.

  3. Run Gaia Sky VR — Launch Gaia Sky VR and it should connect to your active OpenXR runtime automatically. Refer to the following sub-sections to learn how to launch Gaia Sky VR for your system.

Windows#

The easiest way to get it running in Windows is to install the latest version of Gaia Sky and directly run the executable gaiaskyvr.exe file. You should also have a start menu entry called ‘Gaia Sky VR’, if you chose to create it during the installation.

Linux#

Download and install Gaia Sky, and then run:

$  gaiasky -vr

Depending on your headset, on Linux you can run the open source runtime Monado. We have written a post about in in our website: Gaia Sky VR on Linux.

Downloading datasets#

See the Dataset manager section.

Demo mode#

Gaia Sky VR includes a demo mode, which is very useful to perform public demos where the headset is given away to unexperienced people. In this mode, the controller buttons are disabled (no focussing, changing visibility, etc.), and the joystick movement is simplified to forward and backward. Lateral movement is disabled. You can enable demo mode using the check box provided at startup (welcome window), or in the preferences dialog, controls section.

Mirroring#

Gaia Sky VR displays the view of the left eye to the desktop window by default. While this is useful for demos, if you are using the software yourself, you can gain some performance by disabling this. You can enable or disable desktop mirroring at startup, using the checkbox in the welcome window. This setting can’t be toggled after the VR system has already bin initialized and the scene is playing.

Controls#

OpenXR defines a system-agnostic input scheme where the application defines actions which can be bound to different input device hardware. We offer a set of comprehensive bindings for the Oculus Rift CV1, the HTC Vive, the Valve Index and some others. However, if your headset is not supported you can bind the actions to your controller input yourself in your runtime. Please consult the documentation of your OpenXR runtime to learn how to do so. Here is the list of actions in Gaia Sky. Most actions are duplicated for the left and right VR controllers, as the controllers are mirrored. Actions have a type which can be boolean (button presses), float (a single value is given, 1D axis), vec2 (two values for X and Y, 2D axes), pose (a pose, orientation), and haptics (vibration).

  • Show UI (left and right), boolean

  • Accept (left and right), boolean

  • Camera mode (left and right), boolean

  • Select object (left and right), float

  • Move (left and right), vec2

  • Grip (left and right), pose

  • Aim (left and right), pose

  • Haptics (left and right), haptics

The default controls are the following:

_images/controller-info.png

The default controls for Gaia Sky VR with the Oculus Touch controllers#

Caveats#

Gaia Sky VR has been tested with a very small sample of VR systems. Only the Oculus Rift CV1 and the Valve Index are currently well tested. Please, do not expect everything to work flawlessly with other systems and/or headsets.

Common problems#

  • Make sure your runtime is set as the active OpenXR runtime.

  • If you experience low frame rates try using a small and static star catalog like DR3-weeny or Hipparcos instead of a Gaia DR3 LOD one.

  • If you are using an Nvidia Optimus-powered laptop, make sure that the java.exe you are using to run Gaia Sky VR is set up properly in the Nvidia Control Panel to use the discrete GPU.