[JUPL] Getting Started v2025.x

[JUPL] Getting Started v2025.x

General Notes

Version 2025.x of our playout solutions currently supports macOS Sonoma (14.8.x), macOS Sequoia (15.7.x) and macOS Tahoe (26.x) on Apple silicon-based Mac minis, Mac Studios and Mac Pros.

  • Customers using AJA SDI video devices: please update your drivers to version 17.5 or higher when running macOS Sonoma or macOS Sequoia.

  • Customers using Blackmagic Design SDI video devices: please update your drivers to version 15.0 or higher when running macOS Sonoma or macOS Sequoia.

  • We always invite interested parties and prospective customers to evaluate our solutions in combination with their specific workflow requirements by downloading free of charge trial versions of our playout solutions, or to get in touch with ToolsOnAir for further information or clarifications.

Important information before installing

  • An active network connection is mandatory and has to be configured and activated before the Just Play Lite application can be started.

  • 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.

  1. Open the System Settings application.

  2. Go to “Privacy & Security”.

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

  4. Verify that the “App Store & Known Developers” option is selected.

    TOAALL_securitydevelopers.png
  • Download and install the Apple Pro Video Formats Codecs from Apple’s website or use the link provided in the “Run Before Installing” section to directly access the download page.

Video Device Driver Installation

This step is only required if you are planning to use a dedicated SDI video device from either AJA or Blackmagic Design.

  • Download and install the most recent driver from the website of your SDI video device manufacturer (AJA or Blackmagic Design) taking into account the driver information mentioned above.

Downloading the Just Play Lite application and preparing your playout system

The latest version of the Just Play Lite application is freely available for Download via the dedicated solution page.

  • Extract the downloaded ZIP archive and open the disk image. The Just Play Lite installation disk image (.dmg) will appear on your screen as shown below:

JUPL2025_dmg.png

Installation of the Just Play Lite/Composition Builder applications

  1. Drag the Just Play Lite application from the disk image to the Applications folder.

  2. Drag the Composition Builder application from the disk image to the Applications folder, if you are planning to create your own real-time graphics templates or adapt the provided samples.

  3. Once done with the installation, eject the disk image by dragging it over the “Bin” symbol or by using the shortcut “Command-E”.

  4. Finally, open a Finder window and navigate to the Applications folder.

  5. Add (“Drag & Drop”) the Just Play Lite (and Composition Builder if installed) application(s) to your macOS Dock for faster access.

Installation of the Apple Pro Video Formats

  • Please download and install the Apple Pro Video Formats Codecs from Apple’s website, as they provide support for the listed codecs (see screenshot below) and ensure compatibility with professional video playout workflows.

JIM2025_appleprovideoformats30.png
TOALL2025_AppleProFormatsLocation.png

If this has already been done, no further action is needed. For your reference, the Apple Pro Video Formats codecs can be found at: “/Library/Video/Professional Video Workflow Plug-Ins”.

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

This is only recommended if you are in need of a complete software uninstall/reinstall as instructed by a ToolsOnAir support staff member!

IMPORTANT: Allow “Local Network” access in macOS Sequoia (15.x.x) or higher

The new Local Network Security feature in macOS Sequoia (15.x.x) enhances privacy and control by allowing users to manage which apps can access their local network.

This feature addresses concerns over unmonitored network access, providing an extra layer of security by ensuring that only trusted applications have access to local network resources, such as printers, file-sharing devices, and other computers.

In macOS Sequoia, users are prompted when an application attempts to access the local network for the first time, enabling them to allow or deny access (“System Settings → Privacy & Security → Local Network”).

When running the Just Play Lite application for the first time on macOS Sequoia, you will be asked to allow it to discover and connect to devices or other applications on your network. Please click on the “Allow” button to proceed with the setup below.

JULL_2025_localnetwork.png

First Run Setup

  • Start the Just Play Lite applications, review/agree the related End User License Agreement (EULA) and click “Accept”.

JUPL2025_welcome.png

Welcome Screen

Screenshot 2025-08-01 at 15.04.09.png

End User License Agreement (EULA)

  • Please read the “Important Notes / Getting Started” document, then click on the “Download” button to install the Composition Builder application, if it is not already installed. The free Composition Builder application allows you to create your own real-time graphics templates or adapt the provided samples.

  • Click “Next” to proceed with the Template Package installation. Then, click “Install” to automatically install a selection of real-time graphics templates, which will later be available in the “Graphics” tab of the Library.

Screenshot 2025-08-01 at 15.04.14.png

Read Me and Composition Builder Download

Screenshot 2025-08-05 at 09.19.50.png

Template Package Installation

  • The Just Play Lite Wizard panel opens.

JUPL2025_firstrun.png
  • First enter the name of your Channel into the name field.

  • Next, select the format you would like to use for playout (e.g., 1080p29.97 8-bit) and make sure to select a

    • 8bit mode in case the final output is NDI®, SRT or UDP

    • RGBA mode in case you would like to play out SDI based fill+key.

  • If you are using a dedicated video device, select AJA or Blackmagic. Otherwise, keep the Virtual option selected, or select one of the available streaming options (e.g., NDISRT, or UDP).

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

    • Video files: ”/Users/yourUserName/Library/Containers/Just Play Lite/Data/Videos”

    • Graphic files: ”/Users/yourUserName/Library/Containers/Just Play Lite/Data/Pictures”

    • Audio files: ”/Users/yourUserName/Library/Containers/Just Play Lite/Data/Music”

    • Playlist files: ”/Users/yourUserName/Library/Containers/Just Play Lite/Data/Documents/Playlists”

  • Selecting the “Include Simple FX layer with station and live bugs” checkbox automatically loads two predefined TOA Demo still images as Channel Station ID Bug and Live Input Bug. This feature can also be enabled or disabled after the initial setup, and the still images can be changed once the installation is complete.

  • Click on the “Configure” button to complete the initial setup. The Just Play Lite user interface should then appear similar to the image shown below.

Screenshot 2025-06-20 at 15.37.26.png

Verify that your Channel is operational

It may take a few seconds for the Channel to start running. To verify that your Channel is active, check the following indicators:

  • In the Just Play Lite interface, the Status should state ONLINE.

  • The CTI (Current Time Indicator) should be  (Green) indicating the actual time.

  • The timecode shows the current time, updating continuously and smoothly.

Untitled 2.jpg

Consult the User Manual for detailed information

You can access the detailed manual of the Just Play Lite application under this link, or via the Help menu in Just Play Lite application.

ToolsOnAir Support System

If you require supplemental information that is not covered in the User Manual, please contact us via the → ToolsOnAir Support System

 

→ Use the sidebar to navigate.