Click here to download the example workspace and related materials for this tutorial.
DownloadOne of the Action Figures, Sam Kusnetz, also works as a sound designer and associate sound designer in New York and around the US. Over the years, he’s developed a set of AppleScripts which he uses in tech rehearsal to help program shows as quickly and cleanly as possible.
This section of the manual will walk you through these scripts and explain what they do and how to use them.
The workspace has three cue lists: Main Cue List, which is where your cues go, Scripts, which is where the script cues live, and Script Variables which is where a few settings for the scripts are stored.
Some of these scripts are built upon concepts or whole scripts created by Rich Walsh, Mic Pool, and Chris Ashworth.
This script creates fade-in cues for all selected Audio, Mic, Video, Camera, and Text cues. The duration of the fade is set using the name of cue “FItime” in the “Script Variables” list.
This script creates fade-out cues for all selected Audio, Mic, Video, Camera, and Text cues. The duration of the fade is set using the name of cue “FOtime” in the “Script Variables” list.
This script sets or changes the main audio level of selected Audio, Mic, Video, and Fade cues.
To set a specific level, enter an asterisk (*) followed by a level, including a + or - sign. For example, if you enter *-12
this script will set the master level of all selected cues to -12
.
To add to or subtract from the current levels of the selected cues, enter either a + or - sign followed by a number. For example, if you have two cues selected whose master levels are currently -20
and -5
, and you enter +5
, the master levels for those cues will become -15
and 0
.
This script sets or changes the pre-wait of the selected cues. If you enter a number, the pre-wait of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the pre-wait of all selected cues.
This script sets or changes the post-wait of the selected cues. If you enter a number, the post-wait of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the post-wait of all selected cues.
This script sets or changes the duration of the selected cues, assuming the selected cues have editable durations. If you enter a number, the duration of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the duration of all selected cues.
This script sets or changes the rate of selected Audio, Video, and Fade cues. If you enter a number, the rate of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the rate of all selected cues.
This script sets or changes the opacity of selected Video, Camera, Text, and Fade cues. If you enter a number, the opacity of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the opacity of all selected cues.
This script sets or changes the layer of selected Video, Camera, Text, and Fade cues. If you enter a number, the layer of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the layer of all selected cues.
This script sets or changes the X scale of selected Video, Camera, Text, and Fade cues. If you enter a number, the X scale of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the X scale of all selected cues.
If the selected cues’ scale ratio is locked, setting the X scale will also set the Y scale and vice versa.
This script sets or changes the Y scale of selected Video, Camera, Text, and Fade cues. If you enter a number, the Y scale of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the Y scale of all selected cues.
If the selected cues’ scale ratio is locked, setting the Y scale will also set the X scale and vice versa.
This script sets or changes the X translation of selected Video, Camera, Text, and Fade cues. If you enter a number, the X translation of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the X translation of all selected cues.
This script sets or changes the Y translation of selected Video, Camera, Text, and Fade cues. If you enter a number, the Y translation of all selected cues will be set to that many seconds. If you enter a + or - sign followed by a number, that many seconds will be added to or subtracted from the Y translation of all selected cues.
This script sets the selected Video, Camera, and Text cues to use the next blend mode. You can learn more about blend modes from the Blend Mode Demo tutorial.
This script sets the selected Video, Camera, and Text cues to use the previous blend mode. You can learn more about blend modes from the Blend Mode Demo tutorial.
This script causes all running Fade cues and Light cues to rush to completion. The duration of the rush is set using the name of cue “FFtime” in the “Script Variables” list.
This script numbers all selected cues within a Group cue using the format “x-y”, where “x” is the cue number of the enclosing Group cue, and “y” is an integer starting from 1 and counting up to the number of selected cues.
Revised May 2023.
Still have a question?
Our support team is always happy to help.