Overlays

StreamForge provides real-time overlays you can add to OBS (or any streaming software that supports browser sources) to display event progress, goals, and more on stream.

Available Overlay Types

Event Timer — Shows the countdown/count-up timer for subathon events
Goals — Displays event goals with progress bars
Power Hour — Highlights when a power hour is active and its multiplier

Adding Overlays to OBS

In your StreamForge dashboard, go to the overlay you want to use
Click Copy Overlay URL to copy the URL to your clipboard
Open OBS and add a new Browser Source
Paste the overlay URL into the URL field
Set the width and height as recommended (typically 800×200 for timers, 400×600 for goals)
Click OK — the overlay updates in real time

💡 Tip

Overlays have transparent backgrounds by default, so they blend seamlessly with your stream scene.

URL Parameters & Customization

Overlay URLs support query parameters for customization. Here are the common parameters:

Parameter	Description	Example
`theme`	Color theme	`theme=dark`
`fontSize`	Base font size in pixels	`fontSize=24`
`accentColor`	Accent color (hex without #)	`accentColor=7c3aed`
`showTitle`	Show/hide the overlay title	`showTitle=false`

Example full overlay URL:

https://streamtools.bifrostlive.com/overlay/timer?token=YOUR_TOKEN&theme=dark&fontSize=20

Overlay Token Security

Each overlay URL includes a unique token tied to your account. This token:

Authenticates the overlay without requiring a sign-in
Is scoped to read-only access for your event data
Can be regenerated at any time from your dashboard if compromised

⚠️ Keep your overlay token private

Don't share your overlay URL publicly. Anyone with the URL can view your event data. If your token is leaked, regenerate it from Settings → Overlays.