OpenTimelineIO - Import/Export

Import and export OpenTimelineIO files directly in Hiero or Nuke Studio. Only tested on Linux and MacOS, but should work on Windows. Compatible with python 3 and Nuke13+

Updated: 12 March 2021

Author: apetrynet

Compatible Nuke versions: 10.5 or later

Compatibility: Linux, Mac, Windows

OpenTimelineIO Import/Export Plugin for Hiero and Nuke Studio

Supported Versions

Import and export .otio files directly from Hiero or Nuke Studio

Features

  • Multiple tracks
  • Tags
  • Markers
  • Simple re-time (reverese, constant slowdown, constant speedup)
  • Fade in/out and cross dissolves
  • Nested sequences are created separately and replaced with gaps in the main sequence.
  • Linked audio/video when clip shares same media source

Requirements

Make sure you have OpenTimelineIO (OTIO) installed on your computer before you install the plugin. The easiest way to install OTIO is through pip.

pip install opentimelineio

You may also install OpenTimelineIO by using the python version which ships with Hiero|NukeStudio. Replace the python version in the example below with the one you find in the applications root folder.

# Example using python 3 shipped with Nuke13+
python3 -m pip install opentimelineio

If you installed OTIO in another way, please make sure you have OTIO's python package available in the PYTHONPATH environment variable.

Installation

The easiest way to install the plugin is to unpack the contents to the .nuke folder in your 'HOME' directory.
For Hiero/Nuke Studio version < 12 extract to the .hiero folder.

~/.nuke/Python/Startup/otioexporter
~/.nuke/Python/StartupUI/otioimporter

If you choose to install the plugin to another location, make sure to append the full path of the folder containing the Python folder to the HIERO_PLUGIN_PATH environment variable.

export HIERO_PLUGIN_PATH=/my/shared/plugin/folder

Usage OTIO Import

Right click in a project bin and select 'Import->Import OTIO'

Import Bin

Or you can add tracks to an existing sequence

Import Sequence

Usage OTIOExportTask

In Hiero's export dialog choose 'Process as Sequence' and create a new preset called 'OTIO Export'.
Add a new PATH and choose 'OTIO Exporter' from the list of available exporters in the CONTENT column.
Make sure to either use the {ext} token or end your filename with an .otio extension.
The 'include tags' checkbox toggles inclusion of tags assigned to clips in the OTIO metadata.

Export Sequence

You may either export entire sequences or selected items in a sequence.

Known Limitations

  • Tags/markers are applied to both clips and track items on import if no metadata indicates source type.

MIT License

Copyright (c) 2021 Daniel Flehner Heen

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the 'Software'), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Sign in or register to download or rate.