just:play v.5 Getting Started

Important: Before Installation

All ToolsOnAir applications for macOS are provided as Apple-compliant disk images (.DMG format). To open the disk image, the Security settings of macOS may need to be adjusted.

When using macOS Monterey (12.7.x):

  1. Open the System Preferences application.

  2. Go to Security & Privacy.

  3. Click on the General tab.

  4. Authorise yourself to Unlock the pane.

  5. Change the setting to allow apps downloaded from App Store and identified developers


When using macOS Ventura (13.6.x) or macOS Sonoma (14.5.x):

  1. Open the System Settings application.

  2. Go to “Security & Privacy”.

  3. Scroll down until you see the “Security” section.

  4. Verify that the “App Store and identified developers” option is selected.

If you are upgrading from an older version of just:play, you might want to make sure that you have a valid v.5.x activation code for this machine before installing the new version.

1. Video Device Driver Installation

This step is only required if you have a dedicated video device from AJA or Blackmagic Design.

Download and install the most recent driver from the website of your video device manufacturer (AJA or Blackmagic Design).

2. Downloading the Software and preparing your System

  1. The latest version of just:play is freely available for Download via the dedicated solution page. Current customers (with account credentials) may also use the download area in the ToolsOnAir Support System.

  2. Open the disk image, review the End User License Agreement (EULA), and confirm by clicking on “Agree” to proceed. You are presented with the Installer Overview page.



  3. Review the linked documents provided in the “Read Before Installing” section, especially the “Important Notes Read Me First” document.

  4. Run the TOA System Checker application(“Run Before Installing” section) and follow the instructions. Review and verify all errors and warnings before continuing.


  5. Download and install the Apple Pro Video Formats Codecs by following the link provided in the “Run Before Installing” section on every Mac running ToolsOnAir playout applications (Just Out, Just Connect, Just Control).

  6. Run the “ToolsOnAir Uninstall” application to completely remove all applications, preferences, settings, presets, channels, schedules and other data related to a previous ToolsOnAir ingest or playout software installation.

3. Installation

  1. Drag the Just Playout folder from the disk image to the Applications folder. This will install all relevant playout software applications.



  2. Eject the disk image afterwards (“Command-E”).

  3. Open a Finder window and navigate to the Just Playout folder inside your Applications folder.


  4. Add (Drag and Drop) the applications Just Out, Just Connect, and Just Control to your Dock.

4. Configuration

  1. Start the Just Out and Just Connect applications and confirm/apply all system-related requests.

  2. Start the Just Control application, which will automatically display the User Login window. We recommend keeping the defined username for now.

  3. Click on the “Login” button.


  4. Once the Just Out and Just Connect applications have been started (as described in step 1) and you want to run all applications on one machine, make sure to enter the IP Address “”, keeping the same Channel Port Number (5000), before clicking on the “Connect” button. This allows you to test and configure your setup independent of your network infrastructure. For final production/On-Air setups, we recommend using the IP address provided by your network administrator.


  5. Make sure the option New Channel is selected, and enter the name of the Channel into the “New Channel” name field.



  6. Select the Format you would like to use for broadcast (Example: 1080i25 8 Bit) and make sure to select a 8bit mode in case the final output is NDI®, SRT or UDP..

  7. Select the option just:play for 24/7 Master Control playout.

  8. When running Just Out, Just Connect, and Just Control on the same machine, please enter the IP Address “” under the section “The channel's primary engine is installed here” to ensure proper testing operations. Keep the same Engine Port Number (5509).

  9. If there is a dedicated Video device, select AJA or Blackmagic, otherwise, keep the Virtual option selected, or, select one of the available streaming options.

  10. Change the Repository Folders if desired. The default Repositories are:

    • Video files:

    • Graphic files:

    • Audio files:

    • Playlist files:

  11. Activating the “Include Simple FX layer with station and live bugs” checkbox loads two TOA Demo still images automatically as Channel Station ID Bug and Live Input Bug. This feature can also be (de)activated after the initial setup and the still images can be changed once the installation is done.

  12. Click the “Configure” button to finish the setup. The Just Control user interface should look similar to the picture below.



  1. In the sidebar, click on the Connections icon.


  2. Drag the previously created Channel from the Connections list onto the empty viewer area.

  3. The connection should now be established, and Just Control looks similar as shown in this screenshot.

5. Accessing the just:play User Interface

  1. Click the button in the middle of the viewer to open the just:play user interface.


  2. The just:play user interface will now be displayed.

6. Verify that your Channel is operational

It may take several seconds before the Channel is running.

  1. In Just Connect the Status of the Channel should be “Playing”, with a  (Green) indicator.


  2. In the just:play interface the Buffer should be higher than 50% and the CTI (Current Time Indicator) should be (Green) (indicating the actual time). The timecode has to show the actual time and has to change constantly without stuttering

7. Read the User Manual

You can find it here or in the Help menu of just:play.


→ Use the sidebar to navigate.