Vrui VR

Download – Vrui VR

  • The Vrui VR toolkit is free software, distributed under the GNU General Public License. To build and install the toolkit, refer to the included README file. The process is usually as simple as “make” followed by “make install,” but some minor changes might have to be made according to the target operating system. There is also a quick installation guide aimed at novice Linux users.

    Instructions on running and writing Vrui applications are contained as HTML documentation in the included Documentation directory.

    All files on this download page are tagged with their SHA1 checksums, to protect downloaders from file corruption or tampering. To check a file after download, run “sha1sum <file name>” in a terminal window, and ensure that the resulting checksum matches the one displayed on this page.

    Installation Scripts

    To further simplify installation for novice Linux users, we now offer installation script files that automate the entire process, including installation of prerequisite packages and downloading the Vrui source tarball. Installation scripts are available for the following Linux distributions:

    • Fedora 24: Build-Fedora.sh (SHA1=93e490fe1b2483806b625306719b14ff5b40aa54). This script should also work for older or newer Fedora versions, but has only been tested on 23 and 24 (64 bit).
    • Ubuntu 16.10 (“Yakkety Yak”) or Linux Mint 18 (“Sarah”): Build-Ubuntu.sh (SHA1=c87a3d324bfc89e693d5cdb7500f56b48300f5e1). This script might not work for older Ubuntu or Linux Mint versions, as the names of several dependency libraries changed. For those older versions, use Build-Ubuntu-Old.sh (SHA1=b837672746d9c51f9cd414b545aa4f27bb07355e)

    To download and run the scripts (on Ubuntu; on Fedora, replace “Build-Ubuntu.sh” with “Build-Fedora.sh”), type the following into a terminal window ($ indicates the terminal prompt, and ~ is shorthand for the user’s home directory, i.e., /home/<username>):

    $ cd ~
    $ wget http://idav.ucdavis.edu/~okreylos/ResDev/Vrui/Build-Ubuntu.sh
    $ sha1sum Build-Ubuntu.sh

    At this point, compare the output of sha1sum to the checksum displayed above, and do not proceed unless they match exactly. If they do match, finish the installation by running:

    $ bash Build-Ubuntu.sh

    The script will ask you to enter your password to install Vrui’s prerequisite packages, and maybe again if Vrui is to be installed in a system location, but will not perform any other administrator-level changes to your system. If everything works, a new window showing a spinning globe will pop up. That’s it! Refer to the Vrui HTML Documentation, section “Using Vrui Applications,” to learn how to interact with the spinning globe and other Vrui applications.The script makes the following changes to the local system:

    • installs prerequisite packages (administator-level change)
    • creates a directory ~/src
    • downloads and unpacks current Vrui tarball into ~/src, creating Vrui’s source directory Vrui-<version>-<release> where <version> is the Vrui version, e.g., 4.2, and <release> is the release number, e.g., 001.
    • installs Vrui and Vrui example applications into /usr/local (administrator-level change)
    • installs device rule files to access 3D input devices or VR headsets into /etc/udev/rules.d (administrator-level change)

    To uninstall Vrui completely, run sudo make uninstall from inside Vrui’s source directory, i.e., ~/src/Vrui-<version>-<release>.Hint for experts: to install Vrui in a different location than /usr/local, say, in ~/Vrui-<version>, run:

    $ bash Build-Ubuntu.sh <installation directory>

    Source Tarballs

    The tarballs available for download below will expand into Vrui-<release>-<build version> directories in the current directory. SHA1 checksums have been provided to secure the tarballs against tampering.

    • Vrui-4.5-004 (3193KB) (SHA1=809297ce461129bfd65ae8642d48249229200cd7) Small improvements and additional scripts for better user experience.
    • Vrui-4.5-002 (3190KB) (SHA1=0fdbff0f381d058d136cfe7d42f30f717fd7a735) Minor improvements in handling of HTC Vive head-mounted displays.
    • Vrui-4.5-001 (3185KB) (SHA1=8ce224ffe96ce40e169cedae2bb2d80b32246ef3) New OpenVR driver module compatible with current SteamVR Lighthouse tracking driver, improvements to device management, overhaul of imaging library.
    • Vrui-4.4-001 (3153KB) (SHA1=7dff4b9e4f7f45facff805f8245aa7f45f7e5a96) More improvements for head-mounted displays, specifically HTC Vive.
    • Vrui-4.3-001 (3123KB) (SHA1=30cc2fd5524e6907359333a56a7eeafd403a111d) This release is marked beta. Continue using Vrui-4.2-006 for production systems. Significant improvements to support for head-mounted displays, specifically HTC Vive. Works with current SteamVR release as of 07/18/2017.
    • Vrui-4.2-006 (3082KB) (SHA1=8fc967fe33ac5fc200240c82775c427796d8a9a3) Added missing OpenVRHost configuration header; put in work-around for black screen problem when displays report their physical sizes as zero.
    • Vrui-4.2-005 (3081KB) (SHA1=3e7b78bef61474e0f32271f540a3cb516cea0e47) Minor improvements and fixes.
    • Vrui-4.2-004 (3075KB) (SHA1=82a7608c27061395a7d1df58b8095660e110d664) Fixed RoomSetup utility.
    • Vrui-4.2-003 (3075KB) (SHA1=5d7367150bd8c0b22f8123acdf926e40a38526bf) Fixed SteamVR configuration and set-up.
    • Vrui-4.2-002 (3074KB) (SHA1=54748cbee0b376562cc2aa432430686ba2b8fbca) Fixed current OpenVR ABI mismatch by editing openvr_driver.h in the Contributed/OpenVR directory. Vive tracking is working until Valve breaks it again. 🙂
    • Vrui-4.2-001 (3072KB) (SHA1=597875f159fe4bf607a61bc1b7baac135c352835) Pretty massive changes, including support for HTC Vive head-mounted display. Release notes to be delivered.
      Note: Valve changed the internal ABI of OpenVR’s tracking server just before I posted Vrui-4.2-001. As a result, Vive support is currently broken, unless you downgrade your SteamVR installation to a version prior to the update to OpenVR version 1.0.3. I am working on fixing this.