Download the Lumberjack Builder app.
You will need transcripts one one of the compatible formats supported by Builder. Builder supports a wide range of text, and document formats, as well as Speechmatics JSON (only Speechmatics JSON, not other JSON formats) format transcripts.
Builder is a document based app, which means that you can work on many projects simultaneously, each in their own document. Each document is self contained (other than media) and can be shared between users. Builder documents have a .ljb suffix. Each document can have multiple stories.
The footage in the Help examples is from the EditStock project "Born on the Island"
By default Builder will link to the same media location as the Clips in FCP X. This works fine if you can share the Library with a story Editor or Producer, but if they want to work remotely, it will be easier to use no media, or proxy media (for small file sizes).
The same solution - use Proxy or Optimized Media - works for media formats that require a Final Cut Pro X camera plug-in, like R3D or C300 media. These are not supported in Builder directly. You can find the details here.
The list of Builder keyboard shortcuts and Glossary is here.
You can play through all the Builder Help in this Playlist. It will take approximately 17 minutes to play through all the Help, or you can view topic specific videos under each heading.
You can import FCP X XML from a file or by dragging a Library, or one (or more) Events to the Builder dock Icon direct from FCP X. You can incrementally update Events from FCP X by importing an updated XML file. The Event structure from FCP X is displayed in Builder.
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.
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 format and the best options from transcription services.
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 one sentence paragraphs during import. These one sentence paragraphs better match the way people add sound bites to a Story.
Builder originally did create paragraphs from transcript documents with paragraph breaks, and it was demoed that way in the early days. But those early demos spent a lot of time breaking down paragraphs, 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 paragraph into sentences
- there are no paragraph breaks in transcripts from SRT or JSON data
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 FCP X Event inside Builder, the Event header will also be removed.
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.
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 paragraphs. The keywords remain and will autocomplete in the Keyword entry box, and be visible in the Keyword Manager.
If you want to retain those keyword ranges, first Export Clips to send the logged Keyword Ranges to the FCP X Event.
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.
While there are powerful clip logging tools in Lumberjack Builder, you can go straight to story building after linking transcriptions and filter from all the source material.
With a paragraph selected you can play by pressing: the play button, the space bar, J, K, or L keys (although L won't do much at the start of a clip). Multicam Clips will play the active angle selected in FCP X when the XML was exported.
A Paragraph is a Keyword Range
You can split a clip into two paragraphs/keyword ranges by inserting the cursor and pressing RETURN on the keyboard.
You can merge contiguous paragraphs by selecting the two (or more) paragraphs to be and clicking on then Join Paragraphs button.
You can merge a selected paragraph with the following paragraph by pressing ]
You can merge the selected paragraph with the previous paragraph by pressing [
When you merge paragraphs the new joined paragraph retains all People and Keywords from the original paragraphs.
IMPORTANT: If you have trimmed a paragraph and added it to a Story, or have trimmed a paragraph in a Story, and you merge that paragraph with an adjacent one in Transcript View, the instances of that paragraph in a Story, or all Stories, will also have the additional, merged, transcript and associated audio and video.
If you split a paragraph in one story, the split paragraphs will be used in all other stories that use that paragraphs. The story will be the same (unlike with merging paragraphs) but will comprise two or more contiguous paragraphs to keep the story intent the same.
There are no restrictions on editing text. Select the text to edit and typ in the replacing text. Similarly you can add punctuation as you would normally. There are no special tools for punctuation or editing. Speakers/People are named in the People filed (Command + p)
Each paragraph can have an unlimited number of content keywords. Each paragraph is a keyword range. The People filed is also a Keyword Range. There must always be a Person keyword.
Select the People field with Command + p. Select the Keywords field with Command + k.
When multiple paragraphs are selected, adding a Person or Keyword adds these to the existing values. If you wish to remove unneeded Keywords, use the Keyword Manager to do it globally.
Each paragraph can have a "paper color" applied to identify the person speaking in that paragraph.
With transcripts that have only infrequent time stamps, there can be some inaccuracies at the paragraph boundaries. You can click the "Show Trimming" button to trim the head or tail of the clip, relative to the transcript.
When a paragraph is selected, and the Playhead is not at the start or end of the Clip, you can trim the Head, or Tail, of a paragraph to the current Playhead position, without activating Trimming.
With the Playhead in the position you want:
Trim the Head to the current Playhead by clicking Trim Head, or press Option + [
Trim the Tail to the current Playhead by clickign Trim Tail, or press Option + ]
Note: If you attempt to trim more than half the duration you will be warned and given a chance to cancel.
Builder includes a powerful, global (to the document) Keyword Manager. Keywords can be deleted without affecting other applied keyword ranges. Keywords can be merged by dropping the correct keyword on the incorrect one.
The Keyword Manager can open Keywords from Lumberjack System's web application and use those to update keywords in this document.
The corrected transcripts with added keywords can be exported to FCP X and will update the original Event with the new metadata. The transcript will appear in the Notes filed of the Keyword Range. You can send direct to a copy of FCP X running ont he same computer, or export zipped XML to send to another computer with FCP X.
It is not immediately obvious in FCP X, how to Filter to the Keyword Range containing the search result is not obvious. If you select the Event, every instance of the Clip will show in the Filtered result.
For successful Filtering you need to select the Keywords - Lumberjack folder (after importing metadata from Builder) before Filtering.
In Story Mode you can filter selects using the Filter box at the top of the Selects column. Builder supports both "OR" and "AND" searching. You can use either type of search and limit it to Favorites only. Selects filter on the words in the transcript and Keywords added to a paragraph.
You can change the search type for the Filter in Transcript and Selects view. The options are to filer either All fields; or just People, Keywords or Transcript.
When a search field is active there’s a little arrow to the right of the magnifying glass, which is the Mac’s subtle way of telling you there’s a menu there.
You can change the search type before doing a search or change to a different filter type re-filters with the same terms.
Stories are built by adding paragraphs from the Selects LIST to the Storyline on the right. You can press the 'e' key to append the paragraph, or drag the paragraph to the location in the Storyline where it fits the story. You can select multiple paragraphs and add them to the story together.
If a paragraph is selected in Selects or Story view, the same paragraph will be selected in the Transcript view. Simply return to Transcript view and the same paragraph will be highlighted in context. When searching in Clip Logging Transcripts or within the Select List, if you select a paragraph within a search result, then clear the result, the paragraph(s) will remain highlighted in context in the Selects list.
To add temporary narration or voice over in the Storyline, select the clip before the narration should start.
Builder will use the System Voice and Language to create an audio file that will be used in FCP X.
Builder can export:
The Story to FCP X as a Project (directly or via zipped XML)
The script of the Story as a text document
The script of the temp narration pieces for approval and recording.
Copyright 2014-2018 Lumberjack System, Inc