Installing OSVR for OS X

Install using Homebrew

You may install OSVR for OS X using our Homebrew repository:

$ brew tap OSVR/osvr
$ brew install osvr-core --HEAD

Building OSVR from source

1. Prerequisites. The prerequisites may be installed using Homebrew. If you prefer to install them manually, the list of prerequisites follows:

   • CMake
   • Boost
   • OpenCV
   • Python 2
   • libfunctionality
   • libusb

2. Acquire the source code. Check out the source code from the OSVR-Core repository.

3. Create a build directory. To keep the source repository clean of temporary and generated build files, create a separate directory to contain the build. We usually create a directory named build inside the OSVR-Core directory.

   $ mkdir build
   $ cd build
   

4. Generate a Makefile. Run CMake to generate a Makefile. Set the CMAKE_INSTALL_PREFIX variable to the location where you would like the OSVR files to be installed:

   $ cmake .. -DCMAKE_INSTALL_PREFIX=~/osvr
   

5. Compile OSVR. Navigate to the build directory you created in step 3 and run make to build OSVR. Optionally run make install to install the OSVR programs, libraries, and sample configuration files.

   $ make
   $ make install
   

Next steps

• Peruse the OSVR reference documentation
• Integrate OSVR with Unity
• Integrate OSVR with Unreal
• Integrate OSVR with your own application
• Write an OSVR plugin

Support

If you need further assistance with installing OSVR, email us at support@osvr.com.