Open RV is an image and sequence viewer for VFX and animation artists. Open RV is high-performant, hardware accelerated, and pipeline-friendly.

RV Documentation

You can build Open RV for Linux, Windows, and macOS. You build it from scratch using the instructions specific to each OS:

• Linux
• Windows
• macOS

You can use source rvmds.sh to add common build aliases into your shell. After the first download following the installation of the required dependencies, use rvbootstrap to set up, configure, and build Open RV with the default options.

After the setup, you can use rvmk to build.

Start the compilation in parallel by adding --parallel[=threadCound] to the build command. This is the same as using -j.

If you desire to keep your third-party builds between build cleanups, set -DRV_DEPS_BASE_DIR=/path/to/third/party.

You can always go to the build directory and call the generator directly.

Once the build ends, you can execute (or debug!) Open RV from the cmake-build directory.

The path to the build is cmake-build/stage/app. The Open RV cmake options set up the environment so you can start the build without RPATH issues.

The recommended method to install Open RV is to invoke the install build step tool using cmake.

The build system allows you to prepackage Open RV using cmake's install command and a prefix.

Then, it's up to you to either sign or package the result, or to do both. It should contain the minimum required to have a full Open RV.

cmake --install cmake-build --prefix /Absolute/path/to/a/destination/folder

You invoke Open RV tests with the following command:

ctest --test-dir cmake-build --extra-verbose

You can run the tests in parallel by specifying --parallel X, where X is the number of tests to run in parallel.

You can apply a filter with the -R flag to specify a regex.

You can run the tests with extra verbosity with the flag --extra-verbose.

Important: You cannot use --extra-verbose with --parallel. It's one or the other, not both.

This repository uses pre-commit to have formatting executed before a commit. To install the hooks:

pre-commit install

Important: When the hooks reformat a file, you need to re-add them to git to have your git commit command executed. Also, you can skip the hook execution by using git commit -n.