Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
59 lines (36 sloc) 2.78 KB


This is for users who wish to get started using the "OTIOView" application to inspect the contents of editorial timelines.

Install Prerequisites

OTIOView has an additional prerequisite to OTIO:

You probably want the prebuilt binary for your platform. PySide2 generally includes a link to the appropriate version of Qt as well.

Install OTIO

  • pip install opentimelineio

Configure Environment Variables for extra adapters

By default, when you install OTIO you will only get the "Core" adapters, which include CMX EDL, Final Cut Pro 7 XML, and the built in JSON format. In order to get access to the "contrib" adapters (which includes the maya sequencer, rv and others) you'll need to set some environment variables. If you need support for these formats, please consult the Adapters documentation page for details

Run OTIOView

Once you have pip installed OpenTimelineIO, you should be able to run:

otioview path/to/your/file.edl

Developer Quickstart

  1. Get the source and submodules:

    • git clone --recursive
  2. To build OTIO only for C++ development (i.e. produce the OTIO C++ libraries and header files), then use cmake:

    • mkdir build
    • cd build
    • cmake .. {options}
    • make install For {options} configure the variables PYTHON_EXECUTABLE, PYTHON_LIBRARY, and CMAKE_INSTALL_PREFIX appropriately.
  3. To build OTIO only for Python development, run one of the following commands:

    • pip install .
    • python install
  4. To build OTIO for Python and also install the OTIO C++ headers and libraries, run the following command:

    • python install --cxx-install-root=/home/someone/cxx-otio-root

    The first time is run, cmake scripts will be created, and the headers and libraries will be installed where you specify. If the C++ or Python sources are subsequently modified, running this command again will build and update everything appropriately.

    To compile your own C++ file referencing the OTIO headers from your C++ build using gcc or clang, add the following -I flags:

    • c++ -c source.cpp -I/home/someone/cxx-otio-root/include -I/home/someone/cxx-otio-root/include/opentimelineio/deps

    To link your own program against your OTIO build using gcc or clang, add the following -L/-l flags:

    • c++ ... -L/home/someone/cxx-otio-root/lib -lopentimelineio

    To use opentime without opentimelineio, link with -lopentime instead, and compile with:

    • c++ -c source.cpp -I/home/someone/cxx-otio-root/include
You can’t perform that action at this time.