Skip to main content

MLT adapter for OpenTimelineIO

Project description

MLT XML Adapter for OpenTimelineIO

Supported Versions Supported Versions Unit tests PyPI - Downloads

When installed, the plugin adds itself to the available adapters in OpenTimelineIO
The MLT XML adapter produces mlt flavored xml files used in conjunction with melt to preview or render timelines.

The adapter is a write-only adapter and can only produce .mlt files, not parse them. For parsing dialects of the mlt format please check out one of the other adapters listed here.

For more information on MLT please visit: www.mltframework.org

Installation

The easiest way to install the adapter is with pip directly from PyPi

# Install
pip install otio-mlt-adapter

# Check if plugin installed correctly
otiopluginfo mlt_xml

If you choose to download the source code and place the package in an alternative location, make sure you append the full path to the plugin_manifest.json file to the OTIO_PLUGIN_MANIFEST_PATH environment variable.

Usage in command line tools

# Straight conversion from otio -> mlt
otioconvert -i source_timeline.otio -o destination_timeline.mlt

# Pass adapter arguments
otioconvert -i source_timeline.otio -o destination_timeline.mlt -A colorspace=709

# Play timeline in melt
melt destination_timeline.mlt

Usage in python

import opentimelineio as otio

# Straight conversion
timeline = otio.adapters.read_from_file('source_timeline.otio')
otio.adapters.write_to_file(timeline, 'converted_timeline.mlt')

# Conversion with adapter argument
timeline = otio.adapters.read_from_file('source_timeline.otio')
otio.adapters.write_to_file(timeline, 'converted_timeline.mlt', colorspace=709)

Supported OTIO Features

OTIO Feature MLT Adapter
Single Track of Clips W-O
Multiple Video Tracks W-O
Audio Tracks & Clips W-O
Gap/Filler W-O
Markers
Nesting W-O
Transitions W-O
Audio/Video Effects
Linear Speed Effects W-O
Fancy Speed Effects
Color Decision List N/A
Image Sequence Reference W-O

Known limitations

  • Audio handling is a bit limited. Clips in audio tracks that share the same source as the video clip above will be ignored as MLT will include the audio from the video track by default.

  • Effects directly applied on Tracks or Stacks are currently not implemented

Feedback

Please submit bug reports etc. through github issues

License

MLT XML adapter is released under the MIT License

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for otio-mlt-adapter, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size otio_mlt_adapter-0.2.0-py2.py3-none-any.whl (9.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size otio-mlt-adapter-0.2.0.tar.gz (14.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page