Make alerts visible, audible, and safe for stream

Add the overlay browser source

The overlay URL is channel-specific and tokenized. Treat it like a stream key: do not show it on stream and regenerate it if it leaks.

1. Open the SoundSlap dashboard and copy the current OBS overlay URL.
2. In OBS, add a new Browser Source.
3. Paste the overlay URL into the URL field.
4. Set the source size to match your canvas, usually 1920x1080 or 1280x720.
5. Place the source above gameplay or camera layers if alerts should appear on top.
6. Use Test Slap from the dashboard and confirm the alert appears.

If the overlay does not appear, refresh the browser source, verify the token URL, and confirm the dashboard shows the overlay as connected.

Fix OBS overlay audio

If the alert appears but no sound plays, the visual layer is working and the problem is usually audio routing, mute state, source monitoring, or the browser source itself.

1. Run a dashboard Test Slap while watching the OBS audio mixer.
2. Confirm the browser source is not muted in OBS.
3. Open Advanced Audio Properties and check whether the source should monitor, output, or both.
4. Make sure the dashboard global volume and per-sound volume are above zero.
5. Refresh the browser source after changing overlay tokens or audio settings.
6. Test a different sound to rule out a broken upload.

When alerts overlap, each active sound should be able to continue playing while another alert starts. If the first sound cuts off, check whether queue or interrupt mode is enabled.

Preview custom HTML alerts safely

Custom alerts can use HTML, CSS, and JavaScript for streamer-specific animations. Keep them lightweight because they run inside the OBS browser source during a live broadcast.

1. Paste custom HTML, CSS, and JavaScript into the dashboard custom alert editor.
2. Preview in the dashboard first to check layout and text fit.
3. Preview in the overlay next to check transparency, scale, duration, and audio timing.
4. Use transparent backgrounds unless the alert is intentionally full-screen.
5. Keep alert duration consistent with your overlay setting so the animation does not disappear early.

A good custom alert should not cover critical gameplay unless the streamer intentionally wants a full-screen moment.

Choose overlap or queue behavior

SoundSlap can be used as a quick reaction layer or a loud interruption layer. The right playback mode depends on how much chaos the streamer wants.

• Use overlap when multiple short sounds should be allowed to play at the same time.
• Use queue mode when sounds should play one after another without stacking.
• Use interrupt mode only for channels that want the newest alert to take priority.
• Pair overlap with stricter cooldowns so viewers cannot flood audio endlessly.

After changing playback behavior, run two test slaps quickly and confirm the result matches the streamer expectation.