.. _gaiasky-vr: .. raw:: html
Since 2.2.1
Gaia Sky VR =========== `Gaia Sky VR `__ is the VR version of Gaia Sky. It runs on multiple headsets and operating systems thanks to Valve's `OpenVR `__, also implemented by `OpenOVR `__. It is developed in the framework of `ESA `__'s `Gaia mission `__ to chart about 1 billion stars of our Galaxy. Running Gaia Sky VR ------------------- The Gaia Sky VR project is the Virtual Reality version of Gaia Sky. At the moment, only `OpenVR `__ is supported. Our tests have been carried out with the **Oculus Rift CV1** headset in under Windows and the **Valve Index** on Windows and Linux. Both work reasonably well. Currently, the regular installation of Gaia Sky also includes the VR version. On windows, you can run it using the ``gaiaskyvr.exe`` file. On Linux, just use the `-vr` parameter. Pre-requisites ^^^^^^^^^^^^^^ The minimum system requirements for running Gaia Sky VR are as following: +------------------------+----------------------------------------------------------------------------------------+ | **VR Headset** | `OpenVR `__-compatible (Oculus Rift, HTC Vive) | +------------------------+----------------------------------------------------------------------------------------+ | **Operating system** | Linux (only supported headsets) / Windows 10 | +------------------------+----------------------------------------------------------------------------------------+ | **CPU** | Intel Core i5 3rd Generation or similar. 4 core or higher recommended | +------------------------+----------------------------------------------------------------------------------------+ | **GPU** | VR-capable GPU (GTX 970 or above) | +------------------------+----------------------------------------------------------------------------------------+ | **Memory** | 8+ GB RAM | +------------------------+----------------------------------------------------------------------------------------+ | **Hard drive** | 1 GB of free disk space (depending on datasets) | +------------------------+----------------------------------------------------------------------------------------+ Software-wise, you will need the following: 1. Follow the provided vendor instructions and install the Oculus app with the runtime. If using a SteamVR headset (HTC Vive/Pro, Valve Index, etc.), just get Steam and download SteamVR. 2. For the Oculus Rift, you need a translation layer from OpenVR to LibOVR. You can either use SteamVR (slower) or OpenOVR (faster). We recommend using OpenOVR, as it is much simpler and faster. 1. **OpenOVR OpenComposite** - Download `OpenOVR's OpenComposite Launcher `__, launch it and select 'Switch to OpenComposite'. That's it. 2. **SteamVR** - Download and install `Steam `__ and then install `SteamVR `__ and launch it. The SteamVR runtime must be running alongside the Oculus Runtime for it to work. 4. `OpenJDK 15+ `__. 5. A `VR-ready rig `__. 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: .. code:: console $ gaiasky -vr Getting the data ---------------- You can use the same data folder for the VR and desktop versions. The download manager should show up automatically at startup. If it does not, force it with the ``-d`` argument (or using ``gradlew core:rund`` if running from sources). Just select the data packs and catalogs that you want to download, press ``Download now`` and wait for the process to finish. .. code:: console $ gaiasky -d You can also download the **data packs manually** `here `__. Controls -------- On the Oculus Rift controller the mappings are as follow: - **Joystick (move)** - move around. - **Trigger** - hold it to select an object and enter focus mode. - **Jystick (push)** - return to free mode. - **A** or **X** - toggle visibility of labels - **B** or **Y** - enable/disable on-screen information - **A** + **B** or **X** + **Y** - show usage info on screen - **Grip** + **Joystick (move)** - rotate around focus, only in focus mode Common problems --------------- - If you are using an 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. - If you experience low frame rates with an Oculus headset, try using OpenOVR OpenComposite instead of SteamVR. - If you don't see the VR controllers, check the output log for a line that starts with ``VRContext - WARN: Could not [...]`` and attach it or the full log file to a `bug report `__. - Make sure you are using Java 15+. More info --------- The project's VR file is `here `__.