Exchanging Content and Metadata with Final Cut Pro

Send media assets and timeline sequences to Final Cut Pro for editing, and receive rendered media and editing decisions in your app.

Overview

Help your users exchange data between Final Cut Pro and your app, and avoid unwieldy manual processes. With FCPXML representing media, metadata, and Final Cut Pro items, your users can send data from your app to Final Cut Pro for editing, or receive rendered media (movies) and editing decisions from Final Cut Pro projects in your app for further processing.

Illustration showing a two-way flow of data between Final Cut Pro and your app, with the Final Cut Pro icon and X M L (to indicate FCPXML) in the middle.

FCPXML is a specialized format that uses XML elements to describe the data going between your app and Final Cut Pro. With FCPXML simplifying the data exchange, app users can:

  • Send large quantities of media from an asset management tool to be edited in Final Cut Pro.

  • Send media clips—annotated with ratings, keywords, and metadata—and let Final Cut Pro organize the incoming media.

  • Receive rendered media and editing decisions for a project—including lists of media used—from Final Cut Pro for further processing, such as color grading and correction.

  • Receive rendered media (movies) in an app to finish and package for delivery, playout, or archiving.

  • Record an audio/video stream and start editing the media in Final Cut Pro while the file is still being recorded.

Review Final Cut Pro Terminology

You should understand XML and be familiar with Final Cut Pro, including the following terminology. (For more information, see What are libraries? and Metadata overview in Final Cut Pro X Help.)

  • Clips represent media assets (including video, audio, and still images) that have been imported into Final Cut Pro. Clips let Final Cut Pro users edit and organize their media without changing the source files.

  • Users organize clips in events.

  • Users add clips and arrange them in a sequence in the Final Cut Pro timeline. A timeline sequence of clips, along with the metadata that describes editing decisions, is called a project.

  • Libraries keep track of all the events, projects, and clips related to a user’s work.

  • Media assets, clips, and projects can have metadata associated with them. Clips can contain ratings and keywords, and projects can include markers to help organize and annotate the media.

Topics

Data Sent from Your App to Final Cut Pro

Sending Media and Metadata to Final Cut Pro

Send media assets, timeline sequences, and metadata from your app to Final Cut Pro.

Supporting Drag and Drop for Data Sent to Final Cut Pro

Add drag and drop support so your users can drag media assets and timeline sequences from your app directly into Final Cut Pro.

Sending Data Programmatically to Final Cut Pro

Manage and streamline the sending of batches of media assets and timeline sequences from your app using Apple events.

Sending Media to Final Cut Pro as It's Recorded

Designate media as a growing file to make it available to users while it’s still being recorded.

Data Received in Your App from Final Cut Pro

Supporting Drag and Drop to Receive Final Cut Pro Data

Add drag and drop support in your app to give users an intuitive way to receive clips, projects, and other items from Final Cut Pro.

Receiving Media and Data Through a Custom Share Destination

Receive rendered media (movies), editing descriptions for project timelines, library archives, and FCPXML for other Final Cut Pro items in your app.

Final Cut Pro XML Format

Creating FCPXML Documents

Describe media assets, editing decisions, metadata, and other items in FCPXML so users can send and receive data between your app and Final Cut Pro.

Describing Final Cut Pro Items in FCPXML

Get examples of how to describe clips, projects, and other items with FCPXML.

Associating Ratings, Keywords, Markers, and Metadata with Media

Organize and annotate the media and projects your users send to and receive from Final Cut Pro.

Using FCPXML to Describe Final Cut Pro Data

Consult this reference to create FCPXML documents that describe the data your app exchanges with Final Cut Pro.