How To

AppleScript & Scripting

CueStudio 2 is scriptable via AppleScript and exposes a command-based API for integration with other applications and show-control systems.

#Basic verbs

  • go: fire the currently armed cue (equivalent to pressing GO).
  • stop: stop the currently playing cue.
  • pause: pause playback.
  • resume: resume playback.
  • panic: stop everything (equivalent to PANIC).
  • goto cue "5": jump to and fire cue number 5.

#Cue-specific verbs

  • fire cue "5": fire a specific cue by number.
  • stop cue "5": stop a specific playing cue.
  • arm cue "5": enable a cue.
  • disarm cue "5": disable a cue.

#Reading and writing cue properties

  • get cue property "5" key "name": returns the name of cue 5.
  • set cue property "5" key "volume" to 0.8: sets the volume of cue 5 to 80%.
  • cue numbers: returns a list of every cue number in the active list.

#Object graph access

You can also reference cues as objects: tell application "CueStudio" set c to cue "5" end tell

#Scriptable properties (partial list)

name, volume, fadeInSeconds, fadeOutSeconds, loopCount, playbackRate, pitchCents, startPointSeconds, endPointSeconds, prewaitSeconds, postwaitSeconds, isDisabled, videoBrightness, videoContrast, videoSaturation, videoHue, videoBlur.

#Shell scripts

Use Script cues to run shell commands during a show, for example, to launch another application, write to a file, or call a web API. Set the cue type to "Shell" in the Script cue's inspector.