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+
OpenTimelineIO - Import/Export
Updated: 12 March 2021
Author: apetrynet
Compatible Nuke versions: 10.5 or later
Compatibility: Linux, Mac, Windows
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'
Or you can add tracks to an existing 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.
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.