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 ” 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 64-bit Linux distributions:

    • Fedora 25-28: Build-Fedora.sh (SHA1=93e490fe1b2483806b625306719b14ff5b40aa54). This script should also work for older or newer Fedora versions, but has only been tested on 25, 27, and 28.
    • Ubuntu 18.04 LTS (“Bionic Beaver”) or Linux Mint 19 (“Tara”): 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>
    

    Installation on Mac OS X

    To simplify installation of Vrui and its required libraries under Mac OS X, KeckCAVES provides a set of homebrew recipes.

    Vrui builds and runs on all versions of Mac OS X starting with 10.4 (“Tiger”), but there are some minor graphics issues on versions 10.6 and higher due to several bugs Apple introduced into the OpenGL 3D graphics library.

    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.6-005 (3152KB) (SHA1=c80cea174fef29e05a10232a6d45868f2a6e5436) Updated OpenVR VRDeviceDaemon module to current release of SteamVR (1.1.3b, 11/27/2018); improved RoomSetup utility.
    • Vrui-4.6-004 (3144KB) (SHA1=483bddebc1d147f41cec0976af299effc8a3a8cf) Yet another change to SteamVR auto-detection code; should now work with all default Steam installations. Very preliminary support for Vive Pro.
    • Vrui-4.6-002 (3145KB) (SHA1=df45198b153693088a51356722390119e4e8e86d) Adapted OpenVR driver to current SteamVR driver interface, changed SteamVR auto-detection code.
    • 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.