Skip to content

Releases: AcademySoftwareFoundation/OpenTimelineIO

Beta 18.1 - Python Wheel Fixes

09 Nov 16:38
4423671

Choose a tag to compare

Pre-release

This release fixes an issue with python wheels on linux.

What's Changed

Full Changelog: v0.18.0...v0.18.1

Beta 18 - November 2025

06 Nov 23:31
209d723

Choose a tag to compare

Pre-release

Summary

This release includes a large number of fixes as well as schema improvements.

Big Changes

  • Add enabled flag to Effect schema
  • Drop Imath 2 support
  • Remove vfx platform 2020 support from README.md, add 2024 and 2025
  • Added a Color primitive structure for assigning colors to elements (this is not meant to represent pixel colors)
  • Per-Track and Per-Clip Color
  • Added --remove-effects feature to otiotool
  • Remove OTIOView from the core library (The old python library is now stored here - though we encourage people to use Raven instead)
  • Add support for C++ symbol visibility
  • Document C++ API with Doxygen markup

What's Changed

New Contributors

Read more

Beta 17 - June 2024

24 Jun 23:48
4440afa

Choose a tag to compare

Beta 17 - June 2024 Pre-release
Pre-release

Summary

This release is focussed on moving adapters from the OTIO core codebase and the contrib area into independently versioned and installable PyPI packages. (#1386)

If you rely on these adapters, please use the OpenTimelineIO-Plugins PyPI package to ensure you continue to receive them after this release.

The OpenTimelineIO native file format adapters will still be present in the opentimelineio python package. These adapters are:

  • otio_json
  • otiod
  • otioz

To get the full set of OTIO adapters, use the OpenTimelineIO-Plugins python package. In addition to the OpenTimelineIO native adapters, you'll also get:

  • AAF
  • ale
  • burnins
  • cmx_3600
  • fcp_xml
  • fcpx_xml
  • hls_playlist
  • maya_sequencer
  • svg
  • xges

The following are not included in the OTIO-maintained top-level packages:

  • kdenlive - Now hosted and supported under the KDE repository
  • rv_session - This adapter was made obsolete by first-party support of OpenTimelineIO in Shotgrid RV and OpenRV

This effort took a lot of help from the community and in particular the following contributors:

Big Change/Breaking Change

Other Changes

New Contributors

Full Changelog: v0.16.0...v0.17.0

Beta 16 - April 2024

04 Apr 17:10
2b9c3a4

Choose a tag to compare

Beta 16 - April 2024 Pre-release
Pre-release

Summary

This release moves from the third party any and optional to C++17 std::any and std::optional (by @darbyjohnston) as well as a collection of enhancements in how the python bindings handle type conversion with C++ (by @JeanChristopheMorinPerso) and the addition of comment to the Marker schema (by @nickblt).

This release also includes an experimental set of editing commands (by @ggarra13) in C++. These are a new set of APIs intended to implement some common editing commands (insert, overwrite, roll, etc.) backed by the OpenTimelineIO data model. These APIs are meant to provide an opportunity to try the concepts and form a base to iterate on, however there may be breaking changes as they evolve.

Important Note About Adapters

This will be the last release to include the full set of adapters. In the next release, most of the adapters will move out into their own PyPI packages as optional plugins.

tl;dr - if you rely on the adapters, please use the OpenTimelineIO-Plugins PyPI package to ensure you continue to receive them after this release.

The OpenTimelineIO native file format adapters will still be present in the opentimelineio python package. These adapters are:

  • otio_json
  • otiod
  • otioz

To get the full set of OTIO adapters, use the OpenTimelineIO-Plugins python package. In addition to the OpenTimelineIO native adapters, you'll also get:

  • AAF
  • ale
  • burnins
  • cmx_3600
  • fcp_xml
  • fcpx_xml
  • hls_playlist
  • maya_sequencer
  • svg
  • xges

The following are not included in the OTIO-maintained top-level packages:

  • kdenlive - Now hosted and supported under the KDE repository
  • rv_session - This adapter was made obsolete by first-party support of OpenTimelineIO in Shotgrid RV and OpenRV

To experiment with what this looks at, check out the 0.17.0 Pre-Release - packages are provided on PyPI to try out.

Big Changes

Breaking Changes

Other Changes

Read more

Beta 17 Pre-Release

24 Oct 19:44
843806e

Choose a tag to compare

Beta 17 Pre-Release Pre-release
Pre-release

Summary

This is a preview release for extracting the "batteries included" file format adapters and moving them to their own repositories and python packages. If you still require the adapters, you should use the opentimelineio-plugins python package which will have a version correlating to each OpenTimelineIO core release.

The release is a Developmental release to give users a chance to try out how the new opentimelineio and opentimelineio-plugins package setups work in their environments. Because this release is an early cut, there are still a collection of tasks to complete before the final release. There are also additional 0.16.0 changes that will be integrated with this release when it is finalized, so please treat it very much as a work-in-progress.

Please provide feedback about your experience in the GitHub issue for adapter break-out - #1386.

How To Install

By default pip won't pick up developmental releases. To try this release, use one of the following:

  • Setting opentimelineio==0.17.0.dev1 as a dependency
  • python -m pip install opentimelineio==0.17.0.dev1
  • python -m pip install --pre opentimelineio

To opt-in to the "batteries-included" package, use any of these variants with the opentimelineio-plugins package.

Important Note About Adapters

Since we've removed the adapters from OpenTimelineIO core, only the OpenTimelineIO native file format adapters are present in the opentimelineio python package. These adapters are:

  • otio_json
  • otiod
  • otioz

To get the full set of OTIO adapters, use the OpenTimelineIO-Plugins python package. In addition to the OpenTimelineIO native adapters, you'll also get:

  • AAF
  • ale
  • burnins
  • cmx_3600
  • fcp_xml
  • fcpx_xml
  • hls_playlist
  • maya_sequencer
  • svg
  • xges

The following are not included in the OTIO-maintained top-level packages:

  • kdenlive - Now hosted and supported under the KDE repository
  • rv_session - This adapter was made obsolete by first-party support of OpenTimelineIO in Shotgrid RV and OpenRV

What's Changed

Full Changelog: v0.15...v0.17.0.dev1

Beta 15 - September 2022

26 Sep 19:15
3703ac7

Choose a tag to compare

Pre-release

Summary

This release introduces Media-multi references (by @rogernelson), spatial coordinates parameters (also by @rogernelson), otiotool command line utility, a schema downgrading system (for writing OTIO files that are compatible with older versions of OTIO), as well as a number of other smaller bug fixes and enhancements across the core and adapters. This is the last version of OTIO that will support python 2.7.

Thank you to the many community members who contributed to this release!

Important Note About OTIO File Backwards Compatibility

This version of OTIO introduces a new version of the Clip schema, Clip.2 (with multiple media reference support). If you need to write out OTIO files that are compatible with older versions of the OTIO library, then you can use the new downgrade feature to save out OTIO files with Clip.1 schema.

Example using otioconvert on the commandline:

❯ otioconvert -i tests/sample_data/nested_example.otio -o /var/tmp/v14_compat.otio -A target_schema_versions="{'Clip':1}" && grep "OTIO_SCHEMA.*Clip" /var/tmp/v14_compat.otio
26:                        "OTIO_SCHEMA": "Clip.1",
75:                                "OTIO_SCHEMA": "Clip.1",
105:                        "OTIO_SCHEMA": "Clip.1",
162:                                "OTIO_SCHEMA": "Clip.1",
192:                        "OTIO_SCHEMA": "Clip.1",
249:                                "OTIO_SCHEMA": "Clip.1",
280:                        "OTIO_SCHEMA": "Clip.1",

C++:

#include <iostream>

#include "opentimelineio/timeline.h"

namespace otio = opentimelineio::OPENTIMELINEIO_VERSION;

void
main()
{
    otio::ErrorStatus err;
    otio::SerializableObject::Retainer<otio::Timeline> timeline(
            dynamic_cast<otio::Timeline*>(
                otio::Timeline::from_json_file(
                    "tests/sample_data/nested_example.otio",
                    &err
                )
            )
    );

    otio::schema_version_map downgrade_manifest = {
        {"Clip", 1},
    };
    timeline->to_json_file("/var/tmp/v14_compat.otio", &err, &downgrade_manifest);
}

python:

import opentimelineio as otio

tl = otio.adapters.read_from_file("tests/sample_data/nested_example.otio")
otio.adapters.write_to_file(
    tl,
    "/var/tmp/v14_compat.otio",
    target_schema_versions={"Clip": 1}
)

Big Changes

  • The OpenTimelineIO project was moved over to the ASWF organization, and a number of changes were made as part of the ASWF graduation process in:
  • AAF Adapter:
    • AAF Adapter: support for reading markers by @timlehr in #1019
    • AAF adapter: added support for keyframed properties by @timlehr in #1151
  • Merge spatial_coordinates to main by @rogernelson in #1219
  • Media Multi-Reference Feature by @rogernelson in #1241
  • Schema Downgrading System by @ssteinbach in #1387
  • otiotool command line utility by @jminor in #1375

Breaking Changes

  • Fixes #1188 BREAKING CHANGE: change "effect" argument to Gap constructor to "effects" by @visajshah in #1292
  • Clip.2 schema as noted above

Other Changes

Read more

Beta 14.1 Patch - November 2021

10 Dec 22:44
8cdda64

Choose a tag to compare

Pre-release

Summary

This release fixes an issue where installation from the sdist (source) package on PyPI would fail. This mostly impacted users with a platform for which we don't provide a prebuilt wheel.

Changes

Beta 14 - October 2021

27 Oct 18:43
4d2f668

Choose a tag to compare

Pre-release

Summary

This release has a number of features, including many backend features that upgrade the CI, build, and release process. Big thanks especially to @KarthikRIyer, @darbyjohnston and @JeanChristopheMorinPerso for their contributions in this and other areas.

Big Things

Other Changes

Read more

Beta 13 - August 2020

24 Aug 18:04
b104129

Choose a tag to compare

Beta 13 - August 2020 Pre-release
Pre-release

This release introduces the ImageSequenceReference schema to OTIO. It adds support for media references that point at sets of files on disk, for example, the rendered EXR frames for a shot. This work was contributed by @apetrynet and @reinecke. It includes RV adapter support.

Additionally, we're starting a restructure of some of the core math libraries built around a more consistent mathematical framework. The first of these changes is shifting to predicates based on Allen's Interval Algebra [https://en.wikipedia.org/wiki/Allen%27s_interval_algebra] .

Big things:
- ImageSequenceReference (@apetrynet and @reinecke) main: #602 #722 w/ #783 #751
- Allen Interval Algebra predicates (@KarthikRIyer) #697
- AAF Reader metadata support #739
- Post adapter write hook added (@apetrynet) #730
- RV native plugin (so that you can read OTIO files from inside RV rather than convert via an adapter to .rvsession files) @avrata and @apetrynet #637

Small things:
- Reverse and dissolve fixes, Wipe transition support was added to the CMX EDL adapter #763 #757 #687
- Fixing up some bugs and algorithms in rationalTime.cpp #755 #721 #692 (@reinecke and @KarthikRIyer)
- Tox changed and our setup.cfg was altered to conform with the new standard
- otioview enhancement: double click to see full track name (@KarthikRIyer) #690
- conform.py example now prints support file suffixes (@TheBigSasha) #676
- FCP7 adapter bug fixes #674
- xges adapter markers and effects support (@hwilkes-igalia) #609
- Fix bugs in the kdenlive adapter (@vpinon) #714
- bumped pin of PyAAF2 version to 1.4.0 #738
- bug fixes in Markers #740 and #592 (@elabrosseRodeofx)

Project related things:
- added issue templates to the github repo #768
- cleaned up developer quickstart documentation #717
- documentation was broken on read the docs, this was fixed #715

Point release to fix windows builds (Beta 12.1)

27 Mar 20:43

Choose a tag to compare

Includes PR #669, which fixes issues in the cmake build system reported on windows machines. As always, please let us know if you see any further issues and alert us! Thanks!