Skip to main content

Browser Source Alerts

StreamingAdd a PayBru browser source to your streaming software to show tips, memberships, and gifts on screen.

Keep the browser source URL private and test the alert look before going live.

The PayBru browser source is a URL you add to your streaming software so on-screen alerts pop up whenever a community event happens. It works with OBS, Streamlabs, Streamlabs Desktop, OBS.Live, vMix, XSplit, or any other software that supports the standard "Browser Source" input.

Works alongside the streaming platforms PayBru can show in your community settings

TwitchKickYouTubeTikTok

What Alerts You Can Show​

A single PayBru browser source can show three types of on-stream alerts:

AlertTriggered byTypical detail shown
Tip alertsA member sends a Pay-a-Bru tipTipper name, ZAR amount, the message they left
Membership alertsA member subscribes, renews, upgrades, or hits a milestoneMember name, tier, duration, months active
Gift alertsSomeone gifts a membership to another memberGifter, recipient, tier, duration in months

You can turn each alert type on or off independently, so a stream that only wants tip pops doesn't have to show membership pop-ups too.

Open Browser Source Settings​

  1. Open the Manage Portal for your community.
  2. Go to Settings > Streaming & Alerts.
  3. Open the Alerts tab (you may also see this listed as Browser Source).
PayBru Settings Streaming and Alerts tab showing stream embed options
The Streaming & Alerts area controls stream embeds, creator hub sources, and alert setup

Create a Browser Source​

  1. Select Create browser source (or open an existing one).
  2. Give it a name you'll recognise — e.g. "Main stream — Twitch".
  3. Choose which alert types it should show: Tips, Memberships, Gifts (any combination).
  4. Save. PayBru generates a unique URL with a private token.
  5. Copy the browser source URL.
Keep the URL private

The URL contains a token that authorises your alerts. Anyone with this link can preview your alert overlay. If it ever leaks, return to this page and use Regenerate token to invalidate the old link.

Customise the Alert Look and Behaviour​

Each browser source has its own settings. Common options:

  • Position — top-left, top-right, bottom-centre, and so on.
  • Animation — slide-in, fade-in, pop-in.
  • Display duration — how long each alert stays on screen.
  • Sound — toggle on/off, upload your own custom sound, or use the default.
  • Text-to-speech — read tip messages aloud, with a choice of voice.
  • Minimum tip amount — hide alerts for very small tips if you want to.
  • Per-field toggles — show or hide the tipper's name, the amount, the message, the gift recipient, the tier name, and so on.
  • Custom CSS — for advanced users who want to fully restyle the overlay.
  • Test mode — preview alerts without a real payment going through.

Add the URL to OBS or Streamlabs​

In OBS Studio:

  1. In Sources, click + and choose Browser.
  2. Name it (e.g. "PayBru alerts") and click OK.
  3. Paste the PayBru browser source URL into the URL field.
  4. Set the Width and Height to match your scene (1920×1080 is a safe default for full-screen scenes).
  5. Leave Control audio via OBS ticked if you want OBS to handle the alert sound through your normal audio mixer.
  6. Click OK.

In Streamlabs Desktop the steps are nearly identical — add a Browser Source in your scene and paste the URL.

For OBS-specific help, see the OBS Browser Source documentation.

Test It Before You Go Live​

  1. In PayBru, use the Send test alert button (or enable Test mode) on the browser source.
  2. Check OBS shows the alert in your preview.
  3. Confirm the size and position look good in your scene.
  4. Turn test mode off before you go live so real alerts come through correctly.

Use One Source per Stream Setup​

If you stream from more than one PC, scene collection, or in collaborations with other creators, create a separate browser source per setup. That way you can:

  • Use different positions or sizes per scene.
  • Mute alert sounds on a guest's stream while keeping them on yours.
  • Regenerate a single URL if a token leaks without breaking your other setups.

Edit or Delete a Browser Source​

  • Go back to Settings > Streaming & Alerts > Alerts.
  • Open the source to update the layout, alert types, or token.
  • Use Delete to remove a source you no longer use — the URL stops working immediately.

Troubleshooting​

  • No alert appears in OBS — confirm the source is set to active, the alert type is enabled, and OBS is connected to the internet.
  • Sound doesn't play — check OBS hasn't muted the source and that Play alert sound is on in PayBru.
  • Member name shows but tier name doesn't — verify the per-field display toggles in the browser source settings.
  • Alerts stop working after sharing the URL — regenerate the token from the browser source page and paste the new URL into OBS.

See Also​