Apple Final Cut Pro X Integration

Welcome to Cantemo Portal’s Final Cut Pro X Integration. Cantemo Portal integrates tightly with Apple Final Cut Pro X. This guide is aimed to give you an understanding of the potential of the Final Cut Pro X Integration and how to adapt it to your own workflows.

When you install the Final Cut Pro X Integration in your Portal system, a number of menu alternatives are added to various pages in the system. These can be used to import media and projects into Final Cut Pro X. It is also possible to set up a watch folder which the agent monitors for new files and uploads them to Portal.

Requirements

The integration with Final Cut Pro X requires Macos 10.7 or later and Final Cut Pro 10.3 or later.

Importing media into Final Cut Pro X

There are various ways of getting media from Portal into your Final Cut Pro.

../../_images/open-from-item.png

You can open media in FCP directly from the item page through the gear box in the top right corner

../../_images/open-from-dock.png

Media can also be opened in FCP directly from the pod in the search results page

An alternative workflow is to add various items into the MediaBin, and open the entire bin in FCP.

../../_images/open-from-bin.png

You can open a set of media assets to FCP directly from your MediaBin

It is also possible to open an entire collection in FCP through the gear box in the top right corner on the collection page.

../../_images/add-from-collection.png

You can open all media in a collection in FCP with a single operation.

Transfering metadata to Final Cut Pro X

The Final Cut Pro X integration can be used to transfer metadata from Portal into Final Cut Pro X. If an item’s Metadata group contains a field which is recognized by Final Cut Pro X, the value will apper in the Item’s metadata. Note that some of these values may require specific formating to be accepted by Final Cut Pro X and values must follow the datatype specified below. Please refer to the Final Cut Pro X documentation for more information.

The following field names are automatically transfered to Final Cut Pro X.

Field Name Data type
Camera Name String
Alpha Handling Integer
Camera Angle String
ColorSpace Override Integer
Anamorphic Override Integer
Deinterlace Boolean
Field Dominance Override Integer
Location String
Reel String
Scene String
Take String
Notes String
../../_images/fcpx-transfer-metadata.png

Metadata fields with matching names will transfer into Final Cut Pro X.

Exporting media back into Portal

Media can be exported from FCP in several different ways. You can either use a watchfolder location or use the direct exports triggered from within Final Cut

Direct export

In FCP X you go to Share -> Export File. In the Share media dialogue, you have to select to open the media file with Cantemo Agent from /Applications

../../_images/fcpx-export-open-with.png

FCP X - Choose open with Cantemo Agent

The export process starts by showing a list of items which can be exported. In FCP X this is the single project you choose to export.

../../_images/fcpx-export-add-metadata.png

The list of projects/sequences that are to be uploaded

You now have to enter metadata for all items you wish to export. This opens up the metadata group which is associated with the user inside Portal.

../../_images/fcpx-export-enter-metadata.png

The metadata form

Once the upload has completed and the import jobs have completed, the items are visible inside Portal.

Watchfolder export

The agent can be configured to monitor a watchfolder. Please see the installation instructions for how to set this up.

To trigger a watchfolder export, you only need to export or copy the media you want to upload into the watchfolder. This will trigger the same export procedure as outlined above.

Working with libraries

Final Cut Pro X 10.1 introduced the concept of libraries, which is a self-contained directory structure. The Final Cut Pro X integration can be used to manage libraries in Portal.

Setting up a watchfolder is a required step when adopting a project workflow with Final Cut Pro X. Please refer to the Final Cut Pro Integration’s Administration Guide for more information on this.

Export Libraries

When you want to export a library you have been working on in Final Cut Pro X, you start by exporting the XML of one of the events or projects within the library. Even though you only export the XML for a single event or project, the entire library and all associated media will be exported to Portal.

../../_images/fcpx-export-project-xml.png

The system will automatically detect which media in the library is not already handled by Portal and will allow you to upload it along with the library. You may choose not to upload the media, in which case that media will be unavailable if the library is opened on another client.

../../_images/fcpx-export-project.png

Once you have exported a library, The Final Cut Pro X integration will link the Final Cut library and the Library Item in Portal together and will continue to update the same Item on subsequent exports. It is particularly important to observe this relationship when working collaboratively and sharing Libraries between users.

Import library

After you have uploaded a library to Portal, it can be accessed through the Portal’s web interface. Libraries can be treated as any other kind of item. They can be organized into Collections and you can use metadata to categorize your libraries.

When you want to open the library on antoher client machine, all you have to do is select “Open In FCP X” in the menu

../../_images/open-project.png

This will import the library into FCP X.

Offline workflow

When you select “Open in FCP X” in Portal, the Cantemo Agent will inspect the media files which are referenced in the local filesystem and if it cannot access any of the files it will offer to download them to the local client instead. This enables users who do not have access to a shared storage medium to still use Portal’s integration with FCP X.

A library which has been downloaded in offline mode can be moved to another disk or even another computer enabling the user to hand off work on a Portal library to a colleague or even an external contractor.

Once the other party is finished with the work, the library can be reconnected to the station with the Portal integration installed and uploaded back into Portal.

Reconnect items

When working with offline workflows, it can sometimes happen that the link between a media file in Final Cut Pro X and the item in Portal gets lost. One example of when this can occur is when a project started out as an online project but the user later used Final Cut Pro’s built in “Consolidate media” feature to copy all media into a library to make it self contained. When this happens, the file will show up as a locally added file when the library is uploaded to Portal. The agent has the ability to reconnect media from the export window. This will compute a checksum of the file and find the item which the file is connect to. After this has been done once the link will be maintained on subsequent project uploads.

../../_images/fcpx-export-relink.png