XML, Transcripts & Clip Management

Import XML, Link or Order Transcripts, and Manage Clips

In Builder NLE you will first import XML from your NLE, link or order transcripts, update Builder documents, remove and replace Clips and Transcripts and export Transcripts.

Import XML

Import the XML from your NLE. Final Cut Pro X users can also drag one or more Events from Final Cut Pro X directly to the Clip list in the Builder interface.

Update Builder Documents

Projects evolve and it is not unusual to have additional material to add to a work in progress.

Builder NLE fully supports updating a Builder document in two ways:

  • Import XML with additional Clips
  • Update one Builder document from another (newer) Builder Document.te with Additional Clips

To update a Builder document with additional Clips, export an updated XML with both the original, and additional, Clips.

Builder will add only the additional Clips, without duplicating any already in the document.

Update from one Builder Document to another Builder Document

It is also possible to update a Builder Document from another Builder document.  For example, a producer or story writer may have started work keywording and organizing the Builder document. When new materials come in they don't want to start over.

Instead, create a new Builder document (or update a copy) and import the new media (or update the Builder document).

Click on the Copy Clips button and choose the Builder document to be updated.

Clips, with their logging and transcripts will be added, with no duplication, to the receiving document.

Link Transcripts to Clips

To link transcripts to your clips, select the pull-down menu item next to the clip name and select "Link to Transcript" (to add a transcript). Match the first Clip to the matching transcript name. (Clip name not media file name.) Clip name can be an AV clip, audio only, Synchronized Clip or Multicam Clip. Builder will find any other transcripts that match clip names, and link to them. If the names do not match, you can still add transcripts one-by-one to each Clip in turn.

Important: Make sure your transcript formatting is correct for Builder. There should be no header or title in the transcript itself. Read more about transcript formats in the next section.

If you accidentally link the wrong transcript to a Clip, or need to update a transcript already linked to a Clip, Remove the Clip, Re-import the XML containing the Clip, and link to the correct or updated transcript.

Note: Time stamps in transcripts are used to align the transcript to the clips. We break the transcript into text blocks during import. These text blocks better match the way people add sound bites to a Story.

Builder originally did create text ranges from transcript documents with text range breaks, and it was demoed that way in the early days. But those early demos spent a lot of time breaking down text ranges, and it became obvious that there should be a better way.

There are three reasons why it was changed to breaking on sentences:

  • shorter sound bites are more useful to work with
  • it is faster in Builder to join together two (or more) sentences than to split a text range into sentences
  • there are no text range breaks in transcripts from SRT  data.
Order Transcripts in Builder

To order an automated transcript for any clip, click on the pull down menu beside the clip name and select “Add to Transcription Batch.” Once added to a batch, the indicator color changes to yellow until the transcription is ready. You can remove a Clip from a Batch by using the same menu item, which will have changed to "Remove from Transcription Batch."

Transcriptions ordered from within Builder will be charged to the credit card on file at 35c per minute. You will only be charged for the minutes in each transcription batch. The credit card charge will show Lumberjack Transcript and the Builder Project name so you can more easily apportion costs to each project.

Transcripts are not included in the trial, but if you want to order transcripts you can add a credit card by following the link from Builder's Preferences.

If you accidentally add a clip to a transcription batch by mistake, you can remove it from the batch from the same menu.

You can add multiple clips that will be processed in one batch.

When you’ve added all the clips for this batch, click on the Batch button to open the batch manager.

You’ll see the clip names and status in the main interface.
At the bottom of the window you’ll see the total duration for the batch, and how much you’ll be charged. We charge only the amount required for each batch to the card on file at Stripe. You can change that card by following the link from Builder’s Preferences.

Choose the language from the pop-up menu. The different English options affect the spelling g in the transcript.

When you’re ready, click Submit to start the process.

IMPORTANT: Do not close the Builder document or quit the app while files are uploading. Doing so will stop the batch uploading and can lead to duplicate transcription charges.

If you have mixed languages to process, create a batch for each language.

Every item in the batch is handled in parallel, so it takes very little time to get the transcripts back. Any batch will only take as long as the longest clip’s processing time.

When the transcript is complete the indicator will turn green and the transcript will be available, aligned to your clips.

The entire process is usually way faster than real time.


Export Transcripts from Builder

You can export Transcripts ordered (and corrected) in Builder to a Text file with time stamps. If the original media has Timecode, the exported time stamps will match the media Timecode.

Export Edited Transcripts and Keywords to the NLE

When you export a Story to the NLE, the Bin or Event information is automatically updated with the Transcript and Keyword information from Builder NLE.

Note: For Final Cut Pro X, select "Replace" in the import options.

In Final Cut Pro X the transcript will appear in the Notes field of the Keyword Range.

In Premiere Pro the transcript will appear in the Notes field of the Marker Range.

Remove Clip (Replace Clip, Replace Transcript)

In order to replace a clip (with an updated version from FCP X); to link to a different (updated) transcript, or to simply remove a Clip from the Builder Project, click on the orange/green button at the right of the Clip and select Remove Clip.

The Clip will be removed from the Builder Project. If this is the last Clip in a Final Cut Pro X Event or Premiere Pro Bin, inside Builder, the Event header will also be removed.

Replace Clip

After removing the clip you want to update, import an updated XML for that FCP X Event. Only Clips currently not in the Builder Project will be added.

Replace Transcript

After removing the clip you want to update, import the original (unchanged) XML for that FCP X Event. Only Clips currently not in the Builder Project will be added.

Then link an updated Transcript to the newly imported Clip

Important: There's only one problem with the new Delete Clip function in Builder. It will lose any keywords applied to that clip's text ranges. The keywords remain and will autocomplete in the Keyword entry box, and be visible in the Keyword Manager.


Retain Keywords when Deleting a Clip

If you want to retain those keyword ranges, first Export Clips to send the logged Ranges to the FCP X Event or Premiere Pro Bin they came from.

When you're ready to add the Clip back to Builder (perhaps with an updated transcript) then export new XML from FCP X (or drag and drop the Event). When you link the updated transcript the keyword ranges from FCP X (that originated in Builder) will be applied to the new Clip/Transcript combination.