Activity Alert Widget

The Activity Alert Widget shows live stream alerts in OBS and other tools that support browser sources. It can display follows, subs, gifts, raids, donations, rewards and other activity from your connected platforms.

It works out of the box with default alerts, but you can also build your own branded alert pack with reusable themes, reusable sound and media packs, text-to-speech, custom CSS and custom TypeScript.

Supported providers

Provider	Supported alerts
Twitch	New sub, resub, gift sub, gift subs, raid, shoutout, charity donation, bits, follow, channel points redeem, watch streak
YouTube	New member, Super Chat, Super Sticker, member gifting, member milestone
TikTok	Gift, follow, share, like, Super Fan, Super Fan Box
Kick	New sub, resub, gift subs, gift sub, follow, Kicks, reward redeem
StreamElements	Tip
Streamlabs	Donation
Ko-fi	Donation, subscription, shop order, commission
Patreon	New member, pledge

Synchra creates default rules for every supported alert type, so you can start simple and customize only the alerts you care about.

Quick setup

1. Open the Synchra Dashboard.
2. Go to Widgets.
3. Create an Activity Alerts widget.
4. Click Widget URL and copy the URL.
5. Add it to OBS as a Browser Source.
6. Set the source size to match your stream, for example 1920x1080, 800x600 or whatever fits your stream layout.

Recommended setup

Start with one group and the default rules. Pick a theme, adjust colors and font size, then set up sound, media and TTS packs for common alert types like subs and donations.

Create variants only when an alert needs special behavior, such as large donations, long resubs or high-value raids.

Media, sound, TTS and variant packs

Media, sound, TTS and variant packs make shared alert assets easy to manage across platforms. Put your follow, sub, donation or raid media, sounds and voices in packs, then select those packs on any matching variants.

Default pack slots are included for follows, subscriptions, gifted subscriptions, donations, gifts, raids and redeems. Customize a default pack once, and every variant using that pack gets the update. Variants can still add their own single media items, sounds or TTS voices on top. Variant packs can refine a variant after it matches, for example to share special tier, amount or keyword versions across multiple rules. Pack items can also have match conditions, so you can decide when one sound, media item or TTS voice is used without creating another variant.

What you can customize

• Alert text for each activity type.
• Colors, font size, max width, duration and animations.
• Reusable themes for a consistent look.
• Reusable media, sound, TTS and variant packs for shared alert assets.
• Image or video media.
• Separate alert sounds, media sounds, or imports from Sound Alerts.
• Text-to-speech from connected TTS providers.
• Custom TypeScript scripts for advanced behavior.
• Variants for different amounts, counts or sub types.
• Chance controls for variants, media, sounds and TTS voices.
• Queue delay between alerts.
• Pause, mute, skip, play next and replay controls.
• Export and import widget settings as JSON.

How alerts are organized

Part	What it does
Group	A full alert setup. Only the active group plays. Use groups for normal, event or seasonal alert packs.
Rule	Matches one alert type, such as Twitch raid or Streamlabs donation.
Variant	A version of a rule with its own text, filters, media, sound, TTS and CSS.
Theme	Reusable colors, animations and CSS.
Media, sound or TTS pack	Reusable assets shared by variants across providers.
Variant pack	Reusable variant refinements selected after a base variant matches.

When activity comes in, Synchra checks the active group, finds the matching rule, then picks the best matching variant. If that variant has active variant packs, Synchra then picks the best matching pack variant and merges it with the base variant. If multiple variants or pack items match equally well, chance decides which one plays.

Variants and filters

Variants let one alert type have multiple versions.

Useful examples:

• Small donation: simple alert.
• Large donation: bigger animation and TTS.
• Resub from 1 to 5 months: normal alert.
• Resub from 12 months and up: special alert.
• Twitch sub tier 3000: premium alert.

Filters can use value ranges and sub types when the provider sends that data. For example, Twitch subs can filter by Prime, T1, T2 or T3. Filters can also use message keywords for activity types that include a viewer message. More specific matches win before chance is applied, so a high-chance generic variant will not override a matching specific variant.

Text templates

The title and message fields support variables.

Variable	Meaning
{user} or {viewer}	Viewer display name.
{viewer_name}	Viewer username.
{recipient}	Gift recipient display name, when available.
{recipient_name}	Gift recipient username, when available.
{amount}	Formatted money amount, when available.
{value} or {count}	Count value, such as months, subs, bits or viewers.
{unit} or {count_name}	Count name, such as months, subs or bits.
{type}	Activity type display name.
{activity_type}	Raw activity type ID.
{subtype}	Sub type display name, such as a sub tier.
{sub_type}	Raw sub type value.
{provider}	Activity provider, such as twitch or youtube.
{message}	Viewer message, when available.
{system_message}	Provider/system message, when available.

Examples:

{user} just subscribed!
{user} donated {amount}
{user} raided with {value} viewers
Thanks for the {value} {unit}, {user}!

Media, sound and TTS

Media can be an image or video URL. Sounds can be separate sound URLs, or attached directly to a media item with Sound URL.

For reusable assets, put media in media packs and sounds in sound packs. Use packs for common alert categories, then add single media or sounds on a variant only when that variant needs something extra. Each alert selects at most one media item, one alert sound and one TTS voice. If the selected media item has Sound URL, that sound plays instead of the selected separate sound. If the selected media is a video and no separate sound is selected, the video can use its embedded audio; otherwise the video is muted so audio sources do not overlap.

Each media item and sound has:

Setting	Meaning
Chance	100 is normal. Lower values are rarer among same-match picks.
Volume	Volume for that media or sound.
Max duration	Stops long media or audio after the selected time.

TTS uses connected TTS providers, such as TTSMonster, ElevenLabs or Amazon Polly. Create one or more TTS voices, choose what they read, then reuse them through TTS packs.

Each TTS voice can have:

Setting	Meaning
Provider	The connected TTS provider to use.
Voice	The provider voice ID or voice name.
Chance	100 is normal. Lower values are rarer among same-match picks.
Volume	Volume for that TTS voice.
Read	Read the title, the message or both.
Start delay	Extra wait before starting TTS.
Max duration	Stops long TTS after the selected time.

Some providers have extra options. For example, Amazon Polly has an Engine field per TTS voice. Use Test to check API access.

Alert sound plays first. TTS starts after the sound finishes. If you set a TTS start delay, that delay is added after the sound finishes.

Animations and effects

Entry and exit animations:

none, fade, slide_up, slide_down, slide_left, slide_right, pop, bounce, flip, zoom, spin, drop, swing, blur, glitch

Celebration effects:

confetti, fireworks, stars, sparkles, hearts, snow, christmas, halloween, diwali, lunarNewYear, cherryBlossom, stPatricks

Advanced customization

For styling, classes and CSS variables, see Activity Alert CSS.

For TypeScript behavior, lifecycle hooks, fetch examples, replacing HTML, and shared helper functions, see Activity Alert Custom Scripts.