Knowledge Base

Importing ADR Cues from Shooting Scripts & other Unordered Formats

Overview

To import a shooting script, go to File > Import Events from File. ADR Master will recognise the unordered format, & therefore show the Shooting Script Import window instead.

It is also possible to show this window by clicking Import Events As Script from the Import Visual Events from File window at the end of the Ordered File Format import process.

Import Shooting Script Window sections

The window is split into three sections. The top section (1) contains information about the current cue. Here you build up a cue and commit it to the actual cue list. The middle section (2) contains a text field to define the script pattern as well as a number of buttons which will be explained in detail in the following. At the bottom of the window (3), the script is displayed in a line-wise manner.

After selecting a script to be imported, ADR Master will open the window shown above and it will display the script content in the bottom section of the window. ADR Master will try to read the content in a way that makes sense but with elements like pictures, lists, tables etc. all intertwined with the actual text, the outcome may not be perfect. As all scripts are not created according to common standards, it's difficult to optimise the document parsing, as improving scripts from one editor may make the outcome worse for others.

When designing this import functionality, our main goal was not to make it perfect (as that's simply not possible with an undefined format) but rather to make it as convenient as possible for all formats. When analysing scripts, it became apparent that although the formatting may be different with each script, the internal structure doesn't change throughout the script. You'll see what this means in this example:

Script Import window showing repeating pattern

The cue's timecode, character name and text can always be seen. This pattern repeats itself throughout the script. To streamline the import, set the pattern start TC - character - text to the script pattern text field in the middle controller bar. Click the + button to add a new pattern element. Click the x button to remove an element. Drag the elements around within the field to change the order.

Script Pattern example

When clicking on a timecode line with the Alt-key pressed, ADR Master will associate these lines with the correct properties according to script pattern set in the text field.

Click the lock icon to prevent any items in the list from being deleted.

Altclick to auto-select correct properties

To create a cue from these lines, click the first of the four buttons in the middle bar New Cue from Script Selection, or use the shortcut Shift+N.

Creating a new cue from the highlighted property fields

Additional information like the cue number or notes can now also be added. The start and end timecode of the cue can be set here. To do that, either use the controller elements to the left of the timecode fields, type the timecode in manually or grab the start and end timecode from the DAW if attached. The current DAW selection is displayed next to the in and out point text fields and you can take that as in and out either by using the button or the shortcut Cmd+F8. You can also just take the currently displayed video frame as the cue's in point (Cmd+F9) or the cue's out point (Cmd+F10).

When all information is correct for the cue, click the second button in the middle bar to commit the cue to the actual cue list and clear the controls (Commit Cue and Clear Cue Controls, shortcut Shift+C). Alternatively, you can also use the third button (Commit Cue) to only commit the cue without clearing the controls. This can come in handy if the cue has rather long text and if you want to split it into two for easier handling. In that case you can use the last button (Clear Cue Controls) to clear the cue controls to continue.