Developer Portal
Quick StartsComposition scriptingAPIs and SDKsSupport
  • Portal overview
  • Quick start
  • REST API
    • Introduction
    • Rate limits
    • Authorization
    • How-to guides
      • Get a control app's API token
      • Get a composition's sub-composition IDs and names and their payload structures
      • Get a control app's model
      • Get a control app's metadata
      • Update a sub-composition's content
      • Update a sub-composition's animation state
      • Update a sub-composition's content and animation state in one call
      • Update multiple sub-compositions in one call
    • API reference
      • Get control app details
        • Get a control app's metadata
        • Get a control app's model
        • Get a control app's control data
      • Send data to a control app
        • Update a control app's content
        • Update a control app's animation state
      • Take out all of an app's output
  • Data stream API
    • Introduction
    • Rate limits
    • Authorization
    • How-to guides
      • Create a data stream
      • Link a data stream to a composition
      • Send data to an app using the data stream API
    • API reference
  • Composition scripting
    • Introduction
    • Overview
    • Quick start
      • Find sub-compositions and widgets
      • Read and update control nodes
      • Set text widget text properties
      • Read and update widget properties
      • Read control nodes and update widget properties
      • Set image widget URL property
      • Set table widget content property
    • Cheat sheets
      • Fundamentals
      • Interactive overlays
      • Best practices
    • Use cases
      • Read control nodes and generate HTML text
      • Read control nodes, generate HTML text with background
      • Text Ticker - Start ticker on "In" animation
    • Composition script editor reference
  • Software development kits
    • Graphics SDK
      • Getting started
      • Reference
        • SDK functions
        • Composition object
        • Sequencer object
      • Guides and examples
        • Load a composition with its token
        • Load a composition with its URL
        • Get the composition URL of an app instance
        • Sequencer VOD example
        • Control local preview of app
        • Load app instance output
    • Overlay SDK
      • Getting started
      • SDK functions
      • Use case examples
    • Widget SDK
      • Preparing your environment
      • Getting started
      • Reference
        • Widget UI definition
        • Widget callback functions
        • Time control object
        • Composition instance
      • Guides and examples
        • Widget example: CSS patterns
    • App SDK
  • Singular Basics
    • Overview of Singular
    • Managing overlays in the Dashboard
      • How to create a new composition
      • How to open a new app template
      • How to create an app for a composition
      • How to extract a composition from an app
      • How to find an app's shared app token and shared API URL
      • Dashboard reference
    • Building overlays in Composer
      • How to build a composition
      • How to set up layer logic to automate overlay transitions
      • How to set up control nodes to make widget properties available to a control app
      • Animating overlays
        • How to create timeline animations
        • How to create behavior animations
        • How to create update animations
      • How to make overlays interactive
      • How to adapt overlays to various screen sizes
      • Composer reference
    • Controlling overlays in Studio and UNO
      • How to use Studio
      • Studio reference
      • UNO reference
  • Support
    • Singular status
    • Support resources
    • Singular terminology
    • Performance Testing
Powered by GitBook
On this page
  • 1. Download and open the template used in this guide
  • 2. Preview and take In overlays
  • 3. See layer logic in action
  • 4. Change overlay names and content
  • 5. Add overlays and change their order in the playlist
  • 6. See the output in a web browser

Was this helpful?

  1. Singular Basics
  2. Controlling overlays in Studio and UNO

How to use Studio

PreviousControlling overlays in Studio and UNONextStudio reference

Last updated 2 years ago

Was this helpful?

In this guide, you'll get up and running with Studio, Singular's app for controlling live graphics.

Although you don't need it if you use the Singular API, it is useful for previewing app templates.

For best results, use Google Chrome browser.

1. Download and open the template used in this guide

  • Navigate to Dashboard > Templates and download and open the Momentum template.

2. Preview and take In overlays

To preview an overlay

  • Click the name of a sub-composition. It will appear in the preview window.

To take an overlay In or Out (play it live)

  • Press the play button next to the overlay's name. It will appear in the output window.

  • Press the stop button to take it Out.

3. See layer logic in action

In Singular, you can assign layers of the same type or that take up the same space on the screen to a logic layer. Layer logic doesn't allow two overlays on the same layer onscreen at the same time—it animates the first layer Out before the new layer animates In.

To see layer logic in action, follow these steps and watch the output window.

  1. Press the play button next to the Upper Left - 2 Line overlay to take it In.

  2. Press the play button next to the Upper Left - 3 Line overlay to take it In.

Logic layer assignments are shown to the left of the overlay names. Overlays that share a logic layer share the same color.

To see what happens when two overlays share the space on the screen but aren't assign to the same logic layer, follow these steps and watch the output window.

  1. Press the play button next to the Upper Right - 2 Line overlay to take it In.

  2. Press the play button next to the Panel Right - Image + Text overlay to take it In.

4. Change overlay names and content

You can also rename overlays and change their text in Studio. Here's how:

To change text in an overlay

  1. Select an overlay in the playlist. The overlay editor will show an editable overlay name field and text fields.

  2. Change the text in one of the text fields. It will instantly update in the preview window.

To change the name of an overlay name

  1. Select an overlay in the playlist. The overlay editor will show an editable overlay name field and text fields.

  2. Click into the overlay name field in the overlay editor. It will instantly update in the overlay playlist.

5. Add overlays and change their order in the playlist

You can also add and delete overlays on the playlist, as well as reorder them.

To add an overlay to the playlist

  • Press + at the top right of the playlist panel or click Click here to Add Overlay to add an overlay from a drop-down list.

To delete overlays from the playlist

  • Right-click on an overlay in the playlist panel and select Delete.

To change the playlist order

  1. Grab the triple bar icon to the left of an overlay name on the playlist panel.

  2. Drag the overlay to the desired position in the playlist.

6. See the output in a web browser

Now that you have the basics of Studio down, it's time to see how the overlays would look in a video player.

For this tutorial, you'll use a web browser, but you can also use a video player like OBS. Once you integrate the Singular API into your system, you can control and view overlays from there.

  1. Click the Copy URL button to get the output URL.

  2. Paste the Output URL into an internet browser.

  3. Add &bgcolor=green to the end of the URL and press enter. This will set the background color of the webpage to green.

  4. Play around with the Momentum app in Studio with the output webpage open.

Previewing overlays
Taking overlays in and out
Two layers assigned to the same logic layer animating In and Out
Two overlays overlapping
Changing overlay text and names
Adding an overlay to the playlist
Deleting an overlay from the playlist
Changing the playlist order
Copying the output URL
Momentum in a web browser