Open Source API and interchange format for editorial timeline information.
Python Mathematica Makefile
Switch branches/tags
Clone or download
alexwidener and ssteinbach PySide2 support (#160)
* Update for PySide 2 compatibility
* Addresses #153
Latest commit 33ad026 Jul 9, 2018


Main web site:


Discussion Group:!forum/open-timeline-io

Supported Versions Build Status codecov


OpenTimelineIO is currently in Public Beta. That means that it may be missing some essential features and there are large changes planned. During this phase we actively encourage you to provide feedback, requests, comments, and/or contributions.


OpenTimelineIO is an interchange format and API for editorial cut information. OTIO is not a container format for media, rather it contains information about the order and length of cuts and references to external media.

OTIO includes both a file format and an API for manipulating that format. It also includes a plugin architecture for writing adapters to convert from/to existing editorial timeline formats. It also implements a dependency- less library for dealing strictly with time, opentime.

You can provide adapters for your video editing tool or pipeline as needed. Each adapter allows for import/export between that proprietary tool and the OpenTimelineIO format.

Use Cases

  • I have a timeline in Adobe Premiere, and I want to bring that cut into my in-house animation system.
  • I have a timeline in Avid Media Composer, and my Producer wants to know a full list of the media I'm using.
  • I am about to render a bunch of shots & I want to make sure my frame ranges match what Editorial is asking for (not too long or too short).
  • The Editor just added some cross dissolves and I need to know how many more frames (at head or tail) of which shots need to be rendered.
  • Legal needs a list of all the audio we're using (music, effects, dialogue) in the current cut.
  • TDs/Animators want to get a cut from Editorial for reference, and then splice their updated renders/recordings into that cut.
  • Editorial is working with proxy media (QuickTime, MXF, etc.) and I want to gather all the EXRs that correspond with that & bring those into Nuke.

For more use cases, see:




OpenTimelineIO supports, or plans to support, conversion adapters for these formats:

Final Cut Pro XML

Final Cut 7 XML Format

Final Cut Pro X XML Format:

Adobe Premiere Project

  • Based on guidance from Adobe, we support interchange with Adobe Premiere via the FCP 7 XML format (see above).


Avid AAF

Contrib Adapters

The contrib area hosts adapters which come from the community (not supported by the core-otio team) and may require extra dependencies.

RV Session File

  • Status: write-only adapter supported via the rv_session adapter.
  • need to set environment variables to locate py-interp and from within the RV distribution
  • set ${OTIO_RV_PYTHON_BIN} to point at py-interp from within rv, for example: setenv OTIO_RV_PYTHON_BIN /Applications/
  • set ${OTIO_RV_PYTHON_LIB} to point at the parent directory of setenv OTIO_RV_PYTHON_LIB /Applications/

Maya Sequencer

  • Status: supported via the maya_sequencer adapter.
  • set ${OTIO_MAYA_PYTHON_BIN} to point the location of mayapy within the maya installation.

HLS Playlist

  • Status: supported via the hls_playlist adapter.

Avid Log Exchange (ALE)

  • Status: supported via the ale adapter.

Text Burn-in Adapter

Uses FFmpeg to burn text overlays into video media.

  • Status: supported via the burnins adapter.



python install

To build and install the project.


Even though the project is python, we provide a makefile with some utility targets. These include targets for running unit tests and for running a linter to conform to style guide. To run the target:

# run the unit tests
make test
# run the unit tests with verbose output
make test VERBOSE=1
# run the code through a linter
make lint
# generate a coverage report
make coverage


Currently the code base is written against python2.7 and python3.5, in keeping with the pep8 style. We ask that before you submit a pull request, you:

  • run make test -- to ensure that none of the unit tests were broken
  • run make lint -- to conform to pep8
  • run make coverage -- to detect code which isn't covered


You can install development dependencies with pip install -e .[dev]


For more information, please visit or or join our announcement mailing list:!forum/open-timeline-io