🔔 Alerts
Display on-screen notifications for follows, subs, donations, and widget activations.
Overview
The Alerts overlay shows animated notifications when events happen on your stream, keeping viewers informed and celebrating their actions.
Supported Events
Citrus Events
Notifications for Citrus widget activations:
| Event | Description |
|---|---|
| TTS | Text-to-speech messages |
| Sound Alerts | Sound effects triggered |
| Media Share | Videos shared |
| Payphone | Calls connected |
| Prize Wheel | Wheel spins |
| Voicemail | Voicemails received |
| Tips | Juice donations |
| Timeouts | Viewer timeouts |
| Overlay | Interactive overlay access |
Twitch Events
| Event | Description |
|---|---|
| Follow | New followers |
| Sub | New subscriptions |
| Bits | Bit cheers |
| Raid | Incoming raids |
| Hype Train | Hype train progress |
| Poll | Poll results |
| Prediction | Prediction outcomes |
| Charity | Charity donations |
Kick Events
| Event | Description |
|---|---|
| Follow | New followers |
| Sub | New subscriptions |
| Gift Sub | Gifted subs |
| Raid | Incoming raids |
| Host | Hosts received |
YouTube Events
| Event | Description |
|---|---|
| Subscriber | New subscribers |
| Member | New members |
| Super Chat | Super chat donations |
| Super Sticker | Super stickers |
| Milestone | Membership milestones |
Settings
Display Settings
| Setting | Description | Default |
|---|---|---|
| Layout | Alert appearance | Image above |
| Image | Alert animation/image | alert1.gif |
| Sound | Notification sound | alert1.mp3 |
| Duration | How long alerts display (seconds) | 8 |
| Font | Text font style | 7 (Roboto) |
| Size | Text size | 3 |
| Shadow | Text shadow intensity | 0 |
Layout Options
| Layout | Description |
|---|---|
| Image Above | Image on top, text below |
| Image Below | Text on top, image below |
| Image Left | Image to the left of text |
Event Configuration
Each event can be configured for:
- On Screen: Show on the alerts overlay
- In Chat: Announce in chat
Setup Instructions
Step 1: Enable Alerts
- Go to Utilities → Alerts in your dashboard
- Configure your visual preferences
- Enable events you want to show
Step 2: Add Overlay to OBS
- Copy the Alerts overlay URL
- In OBS, add a Browser Source
- Paste the URL
- Set dimensions: 800 x 600 (recommended)
- Position where you want alerts to appear
Step 3: Configure Events
For each event type:
- Toggle On Screen for overlay display
- Toggle In Chat for chat announcements
- Customize as needed
Step 4: Test
- Use the Test Alert button
- Verify positioning and appearance
- Adjust settings as needed
Customizing Alerts
Alert Images
Choose from preset images or use defaults:
- GIF animations for movement
- PNG for static images
- Multiple presets available
Alert Sounds
Select notification sounds:
- Various preset sounds
- Different sounds for different events (coming soon)
Text Styling
Adjust text appearance:
- Font selection from various options
- Size adjustments
- Shadow for readability
Position Settings
| Setting | Description | Default |
|---|---|---|
| Overlay X | Horizontal position | 0 |
| Overlay Y | Vertical position | 0 |
Adjust coordinates to place alerts exactly where you want them.
Troubleshooting
Alerts Not Showing
| Issue | Solution |
|---|---|
| No alerts | Check events are enabled |
| Overlay blank | Verify browser source URL |
| Wrong position | Adjust X/Y coordinates |
Sound Issues
| Issue | Solution |
|---|---|
| No sound | Check browser source audio is on |
| Wrong sound | Update sound selection |
| Too loud/quiet | Adjust in OBS mixer |
Event Issues
| Issue | Solution |
|---|---|
| Follows not showing | Enable Follow event |
| Platform events missing | Check platform connection |
| Wrong platform | Verify correct platform enabled |
Best Practices
- Keep Alerts Visible: Position where they won't be missed
- Don't Overwhelm: Enable only important events
- Test Everything: Verify all enabled alerts work
- Balance Duration: Long enough to see, not too long to annoy
- Match Your Brand: Use consistent colors and styles
FAQ
Q: Can I have different alerts for different events? A: Currently, styling is shared across events.
Q: Do alerts work on all platforms? A: Yes, platform-specific events show when connected.
Q: Can I upload custom alert images? A: Custom uploads coming soon; currently use presets.
Q: How do I turn off specific alerts? A: Disable the "On Screen" toggle for that event.
Q: Can alerts overlap? A: Alerts queue up and display one at a time.