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

  1. In your dashboard, open Settings → Overlays
  2. Click Copy Overlay URL to copy the URL to your clipboard
  3. Open OBS and add a new Browser Source
  4. Paste the overlay URL into the URL field
  5. Set width and height for your scene layout (for example, 800×200 for timers)
  6. 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. Common parameters include:

ParameterDescriptionExample
tokenOverlay authentication tokentoken=YOUR_TOKEN
colorText colorcolor=%23ffffff
bgBackground color (or transparent)bg=transparent
fontFont familyfont=system-ui,sans-serif
sizeBase text scalesize=1.5

Example full overlay URL:

https://streamforge.bifrostlive.com/overlay/YOUR_EVENT_ID/timer?token=YOUR_TOKEN&color=%23ffffff&bg=transparent&font=system-ui,sans-serif&size=1.5

Timer overlays also support advanced parameters such as position, animation, shadow, textShadow, padding, borderRadius, and bgGradient.

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.