---
id: opentimelineio
version: "0.18.1"
license: Apache 2.0 License
license_treatment: permissive
maintenance: active
---

# OpenTimelineIO — Editorial interchange format and API

License: permissive · Maintenance: active · Downloads: 142.3K/mo

## What it is and what it does

OpenTimelineIO is a standardized format and Python library for representing editorial timeline metadata—the sequence, duration, and timing of cuts in a video edit—along with references to external media files. It is not a media container; instead, it focuses on the structural and timing information that describes how clips are arranged. The package includes both a file format specification and a plugin architecture for building adapters that convert between OTIO and proprietary formats used by video editing tools, allowing pipelines to exchange timeline data across different applications.

The library is designed for post-production workflows where editorial decisions need to be shared, versioned, or transformed across multiple tools. It provides a Python API for programmatically reading, creating, and modifying timelines, plus a dependency-less time library (opentime) for handling frame-accurate timing calculations. The package is actively maintained, supports Python 3.9–3.13, and is available as prebuilt wheels for all major platforms.

Use it for:

- Convert editorial timelines between proprietary video editing formats (e.g., Premiere, Final Cut Pro) by writing adapters.
- Programmatically generate or modify video edit sequences in post-production pipelines without manual editing.
- Store and version control editorial decisions as structured metadata separate from media files.
- Build tools that analyze or report on edit structure, timing, and clip relationships.
- Integrate timeline data into asset management or VFX tracking systems.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

OpenTimelineIO provides an interchange format and Python API for representing and manipulating editorial timeline information—the order, length, and timing of cuts—without storing media itself.

Yes, if you work with video editing pipelines or need to interchange timeline metadata across tools. The package is actively maintained, has no runtime dependencies, and is available as prebuilt wheels for modern Python versions. The permissive Apache 2.0 license poses no restrictions. Install friction is moderate but manageable; the main consideration is whether your use case requires writing custom adapters for proprietary formats.

## Install

pip install opentimelineio
uv add opentimelineio
poetry add opentimelineio

## Installing OpenTimelineIO

Before you install: Medium install friction due to compiled wheels; however, prebuilt binaries are available for Python 3.9–3.13 across macOS (ARM64), Linux (x86_64, aarch64), and Windows. The package is actively maintained with a recent commit on 2026-08-07 and no runtime dependencies to manage.

License in practice: Licensed under Apache 2.0 (permissive), allowing commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes, but there are no copyleft obligations.

Quickstart:

pip install opentimelineio

import opentimelineio as otio

timeline = otio.schema.Timeline(name="My Edit")
print(timeline)

Requires Python >3.9.0; prebuilt wheels are available for 3.9–3.13 but older versions will require compilation.

Verify before relying:

- Whether the package includes built-in adapters for specific video editing tools or requires separate plugin installation.
- Performance characteristics when working with large or deeply nested timeline structures.
- Whether the opentime library (mentioned as dependency-less) is bundled or distributed separately.

## Package facts

- License: Apache 2.0 License (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 142.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

editorial timeline format, video editing interchange, timeline data structure, edit decision list api, non-linear editor adapter, cut information interchange, timeline metadata exchange, video-editing, timeline-interchange, post-production

[View on SkillFed](https://skillfed.io/packages/opentimelineio) · [View on PyPI](https://pypi.org/project/opentimelineio/)