There are two wasys of installing OSVR-Core in OS X: using Homebrew or compiling it manually. Unless you're planning to contribute code to OSVR-Core itself, installing with Homebrew is the easier method.
If you don't already have Homebrew installed, install it first following the instructions at http://brew.sh/. You may install OSVR for OS X using our Homebrew repository:
$ brew tap OSVR/osvr
$ brew install osvr-core --HEAD
Once you've installed OSVR-Core using Homebrew, you don't need to build it from source.
- Prerequisites. The prerequisites may be installed using Homebrew. If you prefer to install them manually, the list of prerequisites follows:
-
Acquire the source code. Check out the source code from the OSVR-Core repository.
-
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
-
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
-
Compile OSVR. Navigate to the build directory you created in step 3 and run
make
to build OSVR. Optionally runmake install
to install the OSVR programs, libraries, and sample configuration files.$ make $ make install
- Peruse the OSVR reference documentation
- Integrate OSVR with Unity
- Integrate OSVR with Unreal
- Integrate OSVR with your own application
- Write an OSVR plugin
If you need further assistance with installing OSVR, email us at support@osvr.org
.