Final Cut Pro XML
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 type | None registered |
| Specification | Apple's FCPXML Reference, one version for each Final Cut Pro release. Captions since 1.8. |
| Time precision | Rational seconds, such as 1001/30000s, on the frames of the sequence |
| Text encoding | UTF-8 |
| Styling | Text styles: font, size, italic, bold, underline, colour, and the colour of the box behind |
| Positioning | iTT captions: top, bottom, left or right. CEA-608 captions: a row and column of their grid. |
| Speakers | None |
| In containers | Since 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 · Resources
The version, and the format the sequence uses: its frame size, and how long a frame lasts.
100/2500sis 25 frames a second. - 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 · Caption
Its start on the gap's timeline and its length, and a role: iTT, in English.
- 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
- 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
- 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
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
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.
The release of April 2018 that gave Final Cut Pro captions: imported, edited, and exported as CEA-608 and iTT.
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
Open it in Subtitld with the video and retime it on the waveform.