Final Cut Pro XML

OpenSaveXMLVideo editingFrames

How Final Cut Pro hands a project to other software: its library, events and timelines as XML. Since Final Cut Pro 10.4.1 a timeline can carry captions, each in a role that names its format and language. Subtitld reads them, and writes a project of captions Final Cut Pro imports.

At a glance

Extension.fcpxml
Media typeNone registered
SpecificationApple's FCPXML Reference, one version for each Final Cut Pro release. Captions since 1.8.
Time precisionRational seconds, such as 1001/30000s, on the frames of the sequence
Text encodingUTF-8
StylingText styles: font, size, italic, bold, underline, colour, and the colour of the box behind
PositioningiTT captions: top, bottom, left or right. CEA-608 captions: a row and column of their grid.
SpeakersNone
In containersSince 1.10, a .fcpxmld bundle: a folder with Info.fcpxml in it

Anatomy of a file

A library, an event, a project, and in its timeline, captions anchored to a clip. What Subtitld writes for two subtitles, cut short:

<fcpxml version="1.10">
  <resources><format id="r1" frameDuration="100/2500s" …/>
<library><event name="Subtitld">
<project name="Tears of Steel">
<sequence format="r1" tcStart="3600s" tcFormat="NDF" …>
  <gap offset="3600s" start="0s" duration="28s">
<caption lane="1" offset="23s" duration="3700/2500s"
  role="iTT?captionFormat=ITT.en">
<text placement="bottom">
  <text-style ref="ts1">You're a jerk, Thom.</text-style>
</text>
<text-style-def id="ts1"><text-style fontColor="1 1 1 1" …/>
</caption>
<caption … offset="62800/2500s" …>…</caption>
  1. 1 · Resources

    The version, and the format the sequence uses: its frame size, and how long a frame lasts. 100/2500s is 25 frames a second.

  2. 2 · Timeline

    The sequence, starting at tcStart: 3,600 seconds, or 01:00:00:00. Its storyline holds one gap as long as the subtitles, which the captions hang from.

  3. 3 · Caption

    Its start on the gap's timeline and its length, and a role: iTT, in English.

  4. 4 · Text

    Runs of text, each pointing to the style it is in. The styles are defined beside them.

Times as fractions

A time is seconds, as a fraction when it is not whole, ending in s. Each item's offset is a time on its parent's timeline, which begins where the parent's start says.

Written What it is
23s 23 seconds
62800/2500s 25.12 seconds: frame 628 at 25 a second
1001/30000s One frame at 29.97
tcStart="3600s" A timeline that starts at 01:00:00:00
tcFormat="DF" Its timecode is drop-frame

Final Cut Pro edits on frames. A time between two frames is moved to one. Subtitld writes every start and end on a frame of the sequence's rate.

Roles

A caption's role says its format and language: iTT?captionFormat=ITT.en, CEA-608?captionFormat=CEA608.fr-CA, and SRT in later versions. A project may have captions in several languages, and the same words in more than one format, for players that take one or the other.

Format Where it sits
iTT Apple's TTML: at the top or bottom, or left or right
CEA-608 The grid of TV captions, as in SCC: a row and a column
SRT Nowhere in particular: SubRip has no place

The caption file or the project?

The Export dialog writes FCPXML in two places.

Subtitles: FCPXML Project: Final Cut Pro
Holds The captions, on a gap The video, the captions, and the dubbed speeches on lanes under the video
Translations The original, a translation, or both The original and, if you choose, each translation, a caption language each
For Adding captions to a project you already have Starting the edit in Final Cut Pro

FCPXML in Subtitld

Kept in the .fcpxml
  • Every subtitle's text and line breaks
  • Italic, bold, underline, colour, and the colour of the box behind
  • Top or bottom; left, centre or right
  • A translation, as a second caption language
  • Start and end, to the frame
  • The frame rate, drop-frame and the timeline's start, for saving it again
Nowhere to go
  • Fonts and sizes
  • A place between top and bottom
  • Speakers, dubs, speakers' faces and colours

Save a .usfx project to keep them.

Opening an FCPXML file

Subtitld opens a .fcpxml, or a .fcpxmld bundle, and reads:

  • every caption of the first project that has any, where its clips put it on the timeline, counted from the timeline's start; disabled ones left out;
  • the first role's captions as the subtitles, in its language; another language's as their translations, each beside the subtitle it overlaps most;
  • the same words in the same language in another format (CEA-608 beside iTT) once, not twice;
  • italic, bold, underline, a colour other than white, and a box other than black, as formatting;
  • an iTT caption's placement, a CEA-608 caption's row, and the alignment, as one of nine places;
  • a project's titles, the text drawn into the picture, when it has no captions.

The sequence's frame rate, drop-frame and start are kept, to save it again as it was.

Exporting FCPXML

Subtitld's export dialog with FCPXML chosen, at 29.97 frames a second, drop-frame, the timeline starting at 01:00:00:00

Export, then Subtitles and FCPXML, offers:

  • TextThe original, a translation, or both, as two caption languages.
  • Speaker namesLeft out, or before the text (Thom: …).
  • FormattingKept, or removed.
  • Shift timesEvery subtitle earlier or later by the same amount.
  • Frame rateThe video's, or another: the sequence's.
  • TimecodeDrop-frame or not, at 29.97 and 59.94, the rates that have it.
  • Timeline starts at00:00:00:00, or 01:00:00:00, as editing software starts a sequence.

Subtitld writes FCPXML 1.10, which Final Cut Pro 10.6 and later imports: a library with one event, named Subtitld, and one project, named after the video, its frame the video's size. Each subtitle is an iTT caption, white on black unless it says otherwise; captions that overlap go on lanes of their own. Name the file .fcpxmld to write a bundle instead.

Trivia

2011

Final Cut Pro X 10.0.1 brought XML back to Final Cut, three months after 10.0 shipped without it. Its schema was new: Final Cut Pro 7's XML does not open in it.

10.4.1

The release of April 2018 that gave Final Cut Pro captions: imported, edited, and exported as CEA-608 and iTT.

.fcpxmld

Since Final Cut Pro 10.6, exports at version 1.10 or later are bundles: a folder that holds Info.fcpxml, and room for other files beside it.

Related formats

Have a .fcpxml to fix?

Open it in Subtitld with the video and retime it on the waveform.

Download Subtitld