Connecting to Singular.live

Connect your Singular.live account to SmartPanel for overlay control and content updates.

Prerequisites

A Singular.live account with at least one app (composition) created
Your Singular.live API Token (found in your Singular.live dashboard under Account → API)
The App ID of the composition you want to control

Connecting in SmartPanel

Go to Smart Connect and click + Add Integration
Select Singular.live as the type
Enter a name (e.g., "Singular Lower Thirds")
Paste your API Token — this is encrypted and stored securely
Enter the App ID of the Singular composition
Click Test Connection to verify, then Save

Available actions

Once connected, you can trigger these from Smart Control buttons or Action Sequences:

Action	Description
IN	Animate the overlay in (make it visible on air).
OUT	Animate the overlay out (remove it from air).

<aside> 💡

Tip: Singular.live uses a direct HTTP connection — no middleware needed. SmartPanel sends commands directly to Singular's cloud API.

</aside>

<aside> ⚠️

Note: PATCH actions (updating fields on a live overlay) are currently under investigation. IN and OUT commands work reliably.

</aside>

How credentials are stored

Your API Token is encrypted at rest using pgp_sym_encrypt and only decrypted server-side when executing a command. It is never exposed in the browser or stored in plain text.