## Run External Script

This function is used to run a Mac OS X script.

You specify the script name. Note that a full path is typically required. You also specify which parameters are to be passed to the script. You can quickly choose from None, a path to an audio file or a path to a folder containing an audio file. Alternately, you can select Custom and choose as many parameters as you wish. In addition to the path and folder you can also pass the contents of variables.

Note: due to the nature of the command, when a full path is specified it must be absolute. If you want a path relative to the home folder, use the \h escape sequence as opposed to ~.

> use
> \h/Downloads/scriptfile
> not
> ~/Downloads/scriptfile

The script name may contain any of the escape sequences described in Escape Sequences.

If the filename extension of the script is .yatesh, Yate will set the file's attributes to ensure that it can be executed. With this capability scripts can be created on the fly in actions.

You can elect to have the script run only once per set of files. Note that the single result will be saved to all files when this option is specified. The Run once option is only meaningful when executing stepwise.

If the script cannot be launched the action will be cancelled.

Some scripts may return data to stderr which would normally trigger an error but which you would like to ignore. The Ignore errors option ignores any data returned in stderr.

If you are not ignoring errors, you can choose to cancel the action if the script returns any error information.

The output of the script will be placed into the specified variable. If the script had an error or no output was generated, the variable will be cleared.