Knowledge Base

Importing ADR Cues from Shooting Scripts & other Unordered Formats


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 all the information pertaining to a cue is added.

The middle section (2) contains a text field to define the script pattern as well as a number of buttons used to commit the cue to the actual event list. which will be explained in detail in the following.

If more space is required in the Text & Note fields, click & drag the dividing boundary between section 2 and 3 of the Script Import Window down & up to resize.

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.

To delete unuseful lines from the script, click on the lines & hit the delete button.

Add the standard MacOS Shift or Command key modifiers to add multiple consecutive or non-consecutive lines respectively to the selection.

To edit lines in the script, double-click a line to enter edit mode, place the cursor & start editing. Hit the Return key once done.

Click the Lock Script icon to prevent any items in the list from being inadvertantly edited or deleted.

Alt-click 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. Press the T key shortcut to access the Text field, such that you can start typing in the text (without the need to double-click the Text field window first). In the same way, the C key will access the Character field, The Q key will access the Cue # field, & N will access the Notes field.

The Cue # field can also be incremented using the up & down arrows to the right of the field.

The start and end timecode of the cue can be set here too. 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 the information is correctly entered, click the Commit & Clear button in the middle bar. Or use the shortcut Option + Space Bar. A new ADR Cue Visual Event is then added to the Event List / Timeline. The contents of all the fields are then cleared.

After commiting a cue, the following happens: The playhead jumps to the In point of the newly created cue. The last created cue in the Script Import Window is selected in the Event List. The imported lines in the script will show a light green background & a tick to the left of each imported line. The next recognised fields following the script pattern will be selected & entered into the new cue field boxes above. If there are no new timecode values in the script info, then the last cue’s out timecode value is applied as the next cue’s timecode In value.

In some instances (for example where multiple characters say the same line at the same point), it may be desirable to not have all the fields cleared after commiting a cue. To keep the information in the fields of the current cue for the next cue, use the Commit button instead of *Commit & Clear**

For long lines which require breaking down into multiple cues for better timing reference, Hit T to enter the Text edit mode. Highlight the line wanted as the first cue. Use the keyboard combination Shift + Option + Space to commit the selected Text as the first cue.

Only this keyboard combination works in Text edit mode- ie it is not possible to access the Commit button while in Text Edit mode.

After commiting the cue, the selected part of the text is deleted- leaving the remaining text. The rest of the field info is left the same. Postion the playhead at the start of the next line. Repeat this process until all lines are added.

Once done importing the long cues, use the Clear button to manually clear all the fields, ready for the next cue.

Continue adding all or as many lines - as and when required. The Import Shooting Script window can be kept open in the background of the Project, & be brought up whenever required for cue additions. The current script import progress & changes are kept intact while the window is kept open- even when re-opening a session.