7. Software Installation - Initial and Update (v.4.x)

We assume that you have been configuring all machines using the Hardware Guidelines we have listed in the previous chapters, and that you have followed the recommendations given by the video device vendors regarding the installation of their hardware. Verify this with the following checklist:

  1. The operating system is configured properly.

  2. The hardware is installed/connected properly.

  3. The required video device drivers have been installed, configured and tested.

  4. The network configuration has been done properly.

The installation provides a fully functional demo of our playout applications and the final output will display a watermark. You have to acquire a license to disable the watermark. Please → contact us directly.

macOS Gatekeeper

Before installation it may be required to disable Apple's macOS Gatekeeper temporarily.  When opening one of the playout applications for the first time, it will be verified by the operating system. Usually this process takes up to three minutes. If the verification should not be possible, please follow those steps:

  1. Open the Terminal application.

  2. Enter "sudo spctl --master-disable" (without quotes) and press the Enter key.

  3. You will be asked for the admin password. Enter it and press the Enter key.

  4. Close the Terminal application.

  5. Go to the System Preferences.

  6. Click on Security & Privacy.

  7. Unlock the preference pane.

  8. At the bottom of the General tab select Allow apps downloaded from Anywhere (versions older than macOS Monterey) or Apps Store and identified developers (see below).

  9. Close the System Preferences and open the Just Playout applications.

  10. You may revert the setting after that using “sudo spctl --master-enable” (without quotes).


If you should do an upgrade, please also read the end of this chapter called Installing a new Version over an existing Version.

Refer to https://toolsonair.atlassian.net/wiki/spaces/TST/pages/3355541667 or https://toolsonair.atlassian.net/wiki/spaces/TST/pages/3355541969 for the installation process.

Optional: Install the Template Package which adds a basic set of Realtime Graphics Templates.

Never install composition:builder (our realtime graphics template creation tool) on the machine running Just Out. Starting Composition Builder on such a machine can terminate a running playout!

Installation when using a distributed Playout

You can install and run the Playout from a single machine, or use multiple machines to run a distributed Playout. Refer to chapter https://toolsonair.atlassian.net/wiki/spaces/TST/pages/3355543118for details on how to set up a distributed Playout.

Installing a new Version over an existing Version

Basically, a new installation and updating an older version works the same. But there are a few things you maybe would like to keep in mind when updating to a new version.

1. Preparations

  1. Make a backup of the current installation. Best would be a full backup of the startup disk to another disk. Otherwise, use the backup functionality of Just Connect or copy the Channel folder which can be found at /Library/Application Support/ToolsOnAir/Just Connect to another storage device.

  2. Make sure you have a valid activation code for the new version. Please → contact us if you do not have a valid activation code.

  3. Download the new TOA software version as well as the latest Video device driver and all other driver updates you maybe will need during the installation.

2. Stop the Current Playout

  1. In case you have a redundant playout, switch the failover hardware to the redundant engine.

  2. Quit all TOA applications (on this particular Mac) which are related to the Channel you would like to update, or Deactivate Stay Alive in case it is activated.

Quitting a Just Out engine will stop the current playout.

In case you stop a channel with a redundant engine defined - using the Customer Control configuration window - only the main engine will be stopped, and the redundant engine will remain on air.

In case you stop a channel which has TOA failover activated - using the Customer Control configuration window - only the main engine will be stopped, failover switches to the redundant engine, and the redundant engine will remain on air.

3. Update the Operating System and the Video Device Drivers

  1. Check which OS version is recommended for the new TOA software version from the installer. With version 4.0 we generally support macOS Catalina or higher, which you can download from Apple directly. Version 4.1 add support for macOS Ventura (13.x).

  2. Otherwise, go to the Apple Menu select System Preferences and there select Software Updates.

  3. Make sure to install all available updates for your software until there are no updates left.

  4. Install the latest Video device driver version and all other drivers you may have to update.

  5. Restart the Mac and make sure the Firmware of your Video device is the latest version available.

4. Update the ToolsOnAir Software Versions

  1. Extract the downloaded TOA Software and open the disk image.

  2. Drag and drop the Just Playout folder onto the Applications folder, like described above.

  3. While copying, click on Replace in case you get a warning that a folder already exists.

  4. Delete those applications from the Just Playout folder, which you do not need on the particular machine.

  5. Repeat steps 1–4 on all machines running TOA software related to the updated Channel.

5. Activate the New Version

  1. Once the new version has finished copying, start Just Connect and Just Control.

  2. Follow the instructions in chapter 13.2 Activation to activate the new version.

  3. If required, restart Just Connect

6. Start the Playout

  1. In case you would like to use Stay Alive, start all TOA Applications using Stay Alive.

  2. Otherwise, start all TOA Applications (Just Out, Just Connect and Just Control) which are related to the updated version on this particular machine.

  3. In case you are asked to update the System, agree to do so.

7. Switch to the Primary Playout and Update the Redundant Engine

  1. In case you have a TOA Failover Control, the failover should automatically switch to the Primary Engine after a few seconds.

  2. In case you have another failover solution, switch the failover hardware to the Primary Engine.

  3. Repeat points 3, 4 and 6 also on the machine running the Redundant engine.

→ Use the sidebar to navigate.