Automation manager

The “Automation Manager” allows to configure automations which trigger certain actions by events within the application. This can be used to configure the user interface, apply a video routing configuration, or perform other actions for certain situations.

Automation manager window#

To manage automations, open the “Livegrade” menu and click on “Automation Manager…”.

Within the automation manager, you can

add a new automation by clicking the + button
remove an automation by clicking the – button
modify an automation by clicking the Edit… button

Adding an automation#

When clicking + below the automations table of the Automation Manager, a panel is opened that lets you choose

the event, that shall trigger the event, and
the action, that shall be performed when the event happens.

Click Add to save the new automation.

If the automation is enabled, the chosen action will be triggered automatically when the selected event occurs.

Enabling and disabling automations#

You can enable and disable single automations by checking the checkbox besides the automation in the automation table.

You can enable and disable all automations by clicking the automations button in the toolbar of Livegrade’s main window.

To add the automations button to your toolbar

right-click on the toolbar and select “Customize Toolbar…”
Select the “Automations” button and drag it to a place in the toolbar

Automations log#

A complete log of all automation can be reviewed in the “Event Log” tab of the automation manager. Successful automations, but also error messages of failed actions are displayed there. The event log is cleared when the application quits, so you only see log entries of automations since the last start of the application.

Run scripts as automation action#

You can let the application run scripts automatically on certain events by configuring script actions in the Automation Manager.

You can use any script that is executable in Terminal. The script language is only limited by the available interpreters on your computer. macOS comes with most common interpreters pre-installed (e.g. Python, perl, Bash, ruby), but you can also install you own interpreters (e.g. Lua).

In order to run a script as automation action, move the script into Livegrade’s Scripts folder, which can be found in Livegrade’s project folder. The Scripts folder also contains an example script.

To reveal the Scripts folder

Open the Automations Manager via the menu Livegrade > [Automation Manager…]
Click on + to add a new automation
Within the Action dropdown, select Scripts > [Reveal in Finder]

To run a script on a certain event

Open the Automations Manager via the menu Livegrade > [Automation Manager…]
Click on + to add a new automation
Within the Action dropdown, select Scripts > [YourScript.sh]