Building A Document

Building An ADR or Foley Document

To set up ADR or Foley cues in a Streamers document, first set the Document Mode (in the toolbar) to the microphone icon.

An ADR/Foley document

Adding Reels

The Reels table is where you add all the movie files to which your cues are synced. Click on the + button to choose a movie file, or drag one from Finder onto the Reels table. Then set the SMPTE start time corresponding to the first frame encoded in the movie.

Whichever reel is selected in the Reels table will play back in sync with timecode. By default, the document's reel selection mode is "Auto (Timecode)". This means that the appropriate reel will always be selected based on incoming timecode, and you do not need to select new reels manually. If no reel is selected, the output window will revert to overlay functionality.

Adding Cues

Each cue in an ADR/Foley document is an independent event that may have streamers, punches, beeps, and/or overlay text changes associated with it. When Streamers locks to incoming timecode, it will play all enabled cues that it encounters, so you can loop a section containing multiple cue points. Click on the + button below the cue list to add a cue, or the button to delete any selected cues.

Importing Text Files

Streamers can also import cues from a text file. Drag a text file into the Cues table, or choose Import Text File from the gear pull-down menu to browse for a file. In the dialog that appears next, choose the delimiter that separates the fields in each line, and drag the table headers into the order in which the fields are encoded.

Tags should be encoded as a single field, separated by commas. If your text file is comma-delimited already, place the list of tags in quotation marks to group them together.

Single-Cue Settings

Each cue has the following properties, which you can set in the cue inspector:


If "Enable this cue" is unchecked, the cue is ignored during playback. Any associated streamer, punch, beep, or text settings will not apply until the cue is re-enabled.


This is where you set the cue number, and is for reference only. It does not affect playback.


Each cue is locked to a particular timecode, and any streamers and warning beeps and punches are shifted forward in time as necessary to lead up to the timecode you specify. When one cue is selected, you can nudge it forward and backward frame by frame, using the up and down arrow buttons next to the SMPTE time field, or pressing the ; (semicolon) and ' (apostrophe) keys. You can also lock a selected cue to the current time by pressing Shift-\ or clicking on the registration mark next to the SMPTE time field.


If you specify text here, it will replace the cue overlay text displayed on the output window. (If cue overlay text is not currently shown, press X or select Display > Toggle Cue Text.) The text changes at the same time as the first warning event you specify. For example, if you have a 3-foot (2-second) streamer and no beeps, the text will update 2 seconds before the cue point, when the streamer begins. If you don't specify any text, the overlay will not change.


Tags do not affect playback, but are extremely useful for selecting and deselecting whole categories of cues later on. For an ADR session, you may wish to tag each cue with the name of the character being looped, or with any other property by which you may want to access the cue later on (e.g. voiceover, offscreen, etc.)


If enabled, this option adds a streamer into the cue point. To change the streamer settings that are automatically added to each newly created cue, edit the Default Settings for New Events in the Transport page of Preferences.


If enabled, this option adds a series of beeps leading up to the cue point. The frequency and volume of beeps can be adjusted in the Audio page of Preferences. To change the beep settings that are automatically added to each newly created cue, edit the Default Settings for New Events in the Transport page of Preferences.


You can optionally tell Streamers to punch on each beep. Punches are only supported in conjunction with beeps. (If you need punches and do not want beeps, you can always mute beeps in the Audio page of Preferences.)

Editing Multiple Cues

Certain cue parameters can be batch-edited if you select multiple cues. These include streamer, beep, and punch options, and enabling/disabling cues. This applies also to the Enabled checkbox in the cue list; if you have multiple cues selected and click on one of the checkboxes in the Enabled column, that change will apply to all selected cues.

Using Tags for Selection

If you have defined tags in your cues, you can use them to select or deselect whole groups of cues at once for quick editing and enabling/disabling. To access these options, click on the gear pull-down menu below the cue list, and use the Select by tag and Deselect by tag options. For example, if you have each ADR cue tagged with the name of the character, and you're about to start a looping session with the actor playing Don, you can select all cues by clicking in the cue list and pressing Command-A, then choose Deselect by tag > Don, and disable all the selected cues. Now all of Don's cues will be left enabled and you can loop multiple cues without interference from other characters' cues.

Next Steps

Once you've added cues to your document, you can go on to customize your display settings and take Streamers online.