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):
Open the System Preferences application.
Go to Security & Privacy.
Click on the General tab.
Authorise yourself to Unlock the pane.
Change the setting to allow apps downloaded from App Store and identified developers
When using macOS Ventura (13.6.x) or macOS Sonoma (14.6.x):
Open the System Settings application.
Go to “Security & Privacy”.
Scroll down until you see the “Security” section.
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
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.
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.
Review the linked documents provided in the “Read Before Installing” section, especially the “Important Notes Read Me First” document.
Run the TOA System Checker application(“Run Before Installing” section) and follow the instructions. Review and verify all errors and warnings before continuing.
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).
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
Drag the Just Playout folder from the disk image to the Applications folder. This will install all relevant playout software applications.
Eject the disk image afterwards (“Command-E”).
Open a Finder window and navigate to the Just Playout folder inside your Applications folder.
Just Out provides the final output (Virtual, SDI or NDI® stream). It renders the frames in realtime either on the host GPU (Graphics) or CPU (video file decoding) and should never be quit during playout operations. For more information, please visit: https://toolsonair.atlassian.net/wiki/spaces/TST/pages/3580594405
Just Connect acts like a channel manager, receiving and distributing all the information related to a playout channel. It interconnects to all Just Out engine(s) and Just Control user interface(s) which are related to a particular channel managed by Just Connect. For more information, please visit: 9. Just Connect (v.5.x)
Just Control: is the unified user interface for all ToolsOnAir applications. During the setup, the administrator can define which one of the two available solutions/user interfaces, namely just:live or just:play should be used for a specific channel. For more information about the just:play interface, please visit: just:play v.5 User Interface Manual
Add (Drag and Drop) the applications Just Out, Just Connect, and Just Control to your Dock.
4. Configuration
Start the Just Out and Just Connect applications and confirm/apply all system-related requests.
Start the Just Control application, which will automatically display the User Login window. We recommend keeping the defined username for now.
Click on the “Login” button.
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 “127.0.0.1”, 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.
Make sure the option New Channel is selected, and enter the name of the Channel into the “New Channel” name field.
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..
Select the option just:play for 24/7 Master Control playout.
When running Just Out, Just Connect, and Just Control on the same machine, please enter the IP Address “127.0.0.1” under the section “The channel's primary engine is installed here” to ensure proper testing operations. Keep the same Engine Port Number (5509).
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.
Change the Repository Folders if desired. The default Repositories are:
Video files:
/Users/yourUserName/VideosGraphic files:
/Users/yourUserName/PicturesAudio files:
/Users/yourUserName/MusicPlaylist files:
/Users/yourUserName/Documents/Playlists
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.
Click the “Configure” button to finish the setup. The Just Control user interface should look similar to the picture below.
In the sidebar, click on the Connections icon.
Drag the previously created Channel from the Connections list onto the empty viewer area.
The connection should now be established, and Just Control looks similar as shown in this screenshot.
5. Accessing the just:play User Interface
Click the button in the middle of the viewer to open the just:play user interface.
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.
In Just Connect the Status of the Channel should be “Playing”, with a (Green) indicator.
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.