Main web site: http://opentimeline.io/
GitHub: https://github.com/PixarAnimationStudios/OpenTimelineIO
Discussion Group: https://groups.google.com/forum/#!forum/open-timeline-io
OpenTimelineIO is currently in Public Beta. That means that it may be missing some essential features and there are large changes planned. During this phase we actively encourage you to provide feedback, requests, comments, and/or contributions.
OpenTimelineIO is an interchange format and API for editorial cut information. OTIO is not a container format for media, rather it contains information about the order and length of cuts and references to external media.
OTIO includes both a file format and an API for manipulating that format. It
also includes a plugin architecture for writing adapters to convert
from/to existing editorial timeline formats. It also implements a dependency-
less library for dealing strictly with time, opentime
.
You can provide adapters for your video editing tool or pipeline as needed. Each adapter allows for import/export between that proprietary tool and the OpenTimelineIO format.
- I have a timeline in Adobe Premiere, and I want to bring that cut into my in-house animation system.
- I have a timeline in Avid Media Composer, and my Producer wants to know a full list of the media I'm using.
- I am about to render a bunch of shots & I want to make sure my frame ranges match what Editorial is asking for (not too long or too short).
- The Editor just added some cross dissolves and I need to know how many more frames (at head or tail) of which shots need to be rendered.
- Legal needs a list of all the audio we're using (music, effects, dialogue) in the current cut.
- TDs/Animators want to get a cut from Editorial for reference, and then splice their updated renders/recordings into that cut.
- Editorial is working with proxy media (QuickTime, MXF, etc.) and I want to gather all the EXRs that correspond with that & bring those into Nuke.
For more use cases, see: https://github.com/PixarAnimationStudios/OpenTimelineIO/wiki/Use-Cases
See: https://github.com/PixarAnimationStudios/OpenTimelineIO/wiki/Architecture
OpenTimelineIO supports, or plans to support, conversion adapters for these formats:
Final Cut 7 XML Format
- Status: Supported via the
fcp_xml
adapter - https://developer.apple.com/library/content/documentation/AppleApplications/Reference/FinalCutPro_XML/AboutThisDoc/AboutThisDoc.html#//apple_ref/doc/uid/TP30001152-TPXREF101
Final Cut Pro X XML Format:
- Status: AcademySoftwareFoundation#37
- https://developer.apple.com/library/mac/documentation/FinalCutProX/Reference/FinalCutProXXMLFormat/Introduction/Introduction.html
- Based on guidance from Adobe, we support interchange with Adobe Premiere via the FCP 7 XML format (see above).
- Status: Supported via the
cmx_3600
adapter - Full specification: SMPTE 258M-2004 "For Television −− Transfer of Edit Decision Lists"
- http://xmil.biz/EDL-X/CMX3600.pdf
- https://documentation.apple.com/en/finalcutpro/usermanual/index.html#chapter=96%26section=1
- Status: AcademySoftwareFoundation#1
- http://www.amwa.tv/downloads/specifications/aafobjectspec-v1.1.pdf
- http://www.amwa.tv/downloads/specifications/aafeditprotocol.pdf
The contrib area hosts adapters which come from the community (not supported by the core-otio team) and may require extra dependencies.
- Status: write-only adapter supported via the
rv_session
adapter. - need to set environment variables to locate
py-interp
andrvSession.py
from within the RV distribution - set ${OTIO_RV_PYTHON_BIN} to point at
py-interp
from within rv, for example:setenv OTIO_RV_PYTHON_BIN /Applications/RV64.app/Contents/MacOS/py-interp
- set ${OTIO_RV_PYTHON_LIB} to point at the parent directory of
rvSession.py
:setenv OTIO_RV_PYTHON_LIB /Applications/RV64.app/Contents/src/python
- Status: supported via the
maya_sequencer
adapter. - set ${OTIO_MAYA_PYTHON_BIN} to point the location of
mayapy
within the maya installation.
- Status: supported via the
hls_playlist
adapter.
run:
python setup.py install
To build and install the project.
Even though the project is python, we provide a makefile with some utility targets. These include targets for running unit tests and for running a linter to conform to style guide. To run the target:
# run the unit tests
make test
# run the unit tests with verbose output
make test VERBOSE=1
# run the code through a linter
make lint
# generate a coverage report
make coverage
Currently the code base is written against python2.7 and python3.5, in keeping with the pep8 style. We ask that before you submit a pull request, you:
- run
make test
-- to ensure that none of the unit tests were broken - run
make lint
-- to conform to pep8 - run
make coverage
-- to detect code which isn't covered
PEP8: https://www.python.org/dev/peps/pep-0008/
For more information, please visit http://opentimeline.io/ or https://github.com/PixarAnimationStudios/OpenTimelineIO or join our announcement mailing list: https://groups.google.com/forum/#!forum/open-timeline-io