Alert Guide

What is Donation Alert?#

Donation Alert automatically displays pre-configured text/image/audio on your OBS screen when a specific donation amount is received from any platform. You can set different alerts per platform or apply a common alert across all platforms.

Create URL#

• Enter a name on the Donation Alert page and the URL is generated automatically.
• Copy the generated URL using the ‘Copy URL’ button.
• Paste the copied URL in OBS under Add Source → Browser.
• Recommended size: width 800px, height 600px

Add Alert Rules#

• Click the ’+ Add’ button to create a new alert rule.
• Each rule sets a donation-count range per supported platform (pick a base platform for auto-conversion).
• Enter a donation-count range (min–max); the alert triggers for donations within that range.
• You can create up to 100 alert rules.

Text/Image/Audio Settings#

• Display Text: Enter the text to show in the alert. You can use the following variables:
  • {donor} - Donor name
  • {amount} - Donation amount
  • {platform} - Platform name
• Image: .png, .jpg, .gif, .webp files or a short .mp4 video (max 20MB) or external URL
• Audio: .mp3, .ogg, .oga, .m4a, .wav files (max 10MB) or external URL
• Make sure to click the ‘Save’ button after configuration.

Supported Platforms#

• SOOP — Star Balloons
• YouTube — Super Chat (KRW)
• Twitch — Bits
• Chzzk — Cheese
• Kick — Sub/Gift
• TikTok — Coins
• Douyu — Fish Balls
• Bilibili — Gold
• Huya — Blue Diamonds
• Douyin — Diamonds
• Kuaishou — Coins
• Rumble — Rant ($)

Fun Entertainment Ideas for Your Viewers#

• Tiered alerts by amount: 1,000 KRW = small fireworks GIF, 5,000 = sparklers, 10,000 = full-screen celebration animation! Motivates viewers to donate more
• TTS + variable combos: Fun display text like ‘{donor} just launched {amount}!’ creates hilarious announcements on each donation
• Platform-themed alerts: Red theme for YouTube, purple for Twitch, green for CHZZK! Makes multi-platform streams more vibrant
• Roulette + Alert combo: Set up events where donations above a certain amount trigger a roulette wheel that decides challenges or missions

FAQ#

Q. The alert is not showing.

Check that the OBS browser source URL is correctly set and that the platform and donation amount in the alert rule are accurate.

Q. Can I set multiple alerts for the same amount?

Yes, if you set multiple alert rules for the same platform and amount, they will be displayed sequentially.

Q. Can I use GIF images?

Yes, .gif files are supported. Using animated GIFs can make your alerts more lively.

When changes are not reflected in the URL#

Double-click the source with the URL in OBS, check the ‘Refresh browser when scene becomes active’ checkbox, and click the ‘Refresh cache of current page’ button.

Smart Image Alert#

When a donation within the configured count range is detected during a stream, an image is generated from the prompt and shown on the OBS widget. The image disappears automatically after the set duration.

Create Imagen Settings#

On the Imagen page, entering a name automatically creates new settings and a URL. Register the generated URL in the OBS browser source.

Add Image Generation Rules#

Click the ’+ Add’ button to add image generation rules. Each rule has the following settings:

• Platform — All or specific platforms (YouTube, Twitch, SOOP, Chzzk, Kick, Douyu, etc.)
• Donation amount — The donation-count range (min–max) that triggers generation
• Image prompt — Text describing the image to generate
• Reference image — (Optional) Upload or attach via URL an image for reference

Image Generation Settings#

• Display duration — Time the generated image is shown on screen (1-999 seconds)
• Include donor nickname — When checked, the donor’s nickname is automatically added to the image prompt
• Alert voice — Choose from None / Default alert voice (free) / TTS alert voice (uses credits)

OBS Setup#

1. Copy the URL using the ‘Copy URL’ button.
2. In OBS, select Add Source → Browser.
3. Paste the copied URL in the URL field.
4. Adjust width/height to fit your stream layout. (Recommended: 800×600)

Credit Information#

• Credits are automatically deducted for image generation (the amount varies by model and size).
• Images will not be generated if credits are insufficient.
• You can recharge credits on the Account page.

FAQ#

How long does image generation take?

Usually takes 10-30 seconds.

How many rules can I set up?

You can set up to 100 rules.

What if multiple donations come in at once?

They are automatically queued and processed in order.