01 · OBS Setup

Add the overlay to OBS.

Five steps. No installer, no extension — a dedicated WES Alert scene with a Browser Source pointing at your private overlay URL, reused across every scene that needs alerts. Three minutes, end to end.

Before you start

  • OBS Studio 28 or later. Earlier versions work but the Browser Source defaults changed in 28.
  • An active WES Alert account. Visit your dashboard and confirm you can see the Overlay URL field.
  • Your Twitch channel connected (OAuth in the dashboard).
01

Copy your overlay URL.

In the dashboard, find the Overlay URL block. Click Show to reveal the URL, then Copy. Keep this URL private — it carries your license key.

Shared it by accident? You can rotate the URL anytime from Advanced Settings → Security. See the Security guide for what to do after a regeneration.

Dashboard · Overlay URL
02

Create a dedicated WES Alert scene.

Don't drop the Browser Source straight into your gameplay or BRB scenes. Make one standalone scene that holds the overlay, and reuse it as a source everywhere else. One place to update, no duplicates fighting each other.

Two clicks, in order:

  1. In the Scenes panel (left), click +. Name the new scene WES Alert. Make sure it's selected.
  2. In the Sources panel (right), click +Browser. Name the source WES Alert too.

Why a dedicated scene? Step 04 plugs your overlay URL into this Browser Source. Step 03 reuses this scene as a source in your gameplay scenes — change the URL once, every scene picks it up.

OBS · Scenes & Sources · dedicated WES Alert scene
03

Reuse the scene in every gameplay scene.

In each of your other scenes (game, IRL, BRB, ending…), add the WES Alert scene as a source: click + in SourcesScene → pick WES Alert. OBS treats it as a transparent passthrough — alerts fire on top, nothing else.

This is the OBS pattern for shared overlays: one source of truth, mirrored across every scene with a single click. Update the URL or swap the pack later, every scene follows.

04

Configure the Browser Source.

The Browser Source properties dialog opened when you added the source. Set it up like this — these are the values WES Alert is built and tested against:

  • URL Paste the overlay URL you copied.
  • Width 1920
  • Height 1080
  • Control audio via OBS Off.
  • Use custom frame rate On.
  • FPS 60
  • Custom CSS Leave empty.
  • Shutdown source when not visible Off.
  • Refresh browser when scene becomes active Off.
  • Page permissions Read access to OBS status information.

Click OK. The overlay renders transparent — you won't see anything until an alert fires.

Why 60 FPS? WES Alert uses GSAP timelines tuned for smooth 60 fps motion. OBS defaults to 30 — fine for a logo, choppy for our alert animations. Always force 60 with Use custom frame rate.

Why audio off the OBS mixer? Sound plays directly through the browser engine — the dashboard's volume slider and Smart Volume cascade control the level. Routing through OBS would add a second mixer to debug for no gain.

OBS · Browser Source properties
05

Fire a test alert.

Back in your dashboard, open the Test Alerts panel. Pick an event type — follow, sub, donation — and click Send. The alert should play in OBS within a second.

If nothing happens, check OBS → ViewDocksStats: the Browser Source should report no errors. If it does, see Troubleshooting below.

Troubleshooting

Nothing happens when I send a test alert.
Make sure the Browser Source is in your active scene (visible eye icon). Right-click it → Refresh. If still nothing, your overlay URL might be stale — copy it again from the dashboard (URLs rotate after long inactivity).
The overlay shows a white background instead of being transparent.
OBS Browser Source defaults to opaque on some older versions. In the source properties, expand Custom CSS and confirm nothing forces a background. WES Alert ships with transparent CSS by default.
Alerts play in the dashboard preview but not in OBS.
OBS may have audio routing the WES Alert source through a muted channel. Open Advanced Audio Properties (gear icon on the Audio Mixer) → confirm the Browser Source is unmuted and routed to Track 1.
Where do I find help if this isn't covered?
Reach out via the contact on the Beta page. The closed beta is small enough that we read every email.

Setup done?

Pick a pack, tweak the palette, set your alert position. Everything lives in the dashboard.