Alerts

What this page is

Alerts keeps several alert widgets in one place — as the page describes itself, "one for donations, one for subscriptions. Each has its own events, sources and design". Widgets are kept in groups, and every group is one link for a Browser Source in OBS.

How to set it up

1. Open Alerts. On the first run there is one group, Main, with one widget in it, Donations.
2. Press Create widget. A widget named New widget appears and its editor opens at once. The name is edited in the editor header, next to Back to list.
3. In the left column pick Event. Under Reacts to tick what the widget answers to: donations, bits, followers, subscriptions, gifted sub drops, raids, channel point rewards. The hint below reads "If an event matches several widgets, the most specific one wins — the one with the higher amount threshold."
4. With donations or bits ticked, two more fields appear. Minimum amount — "0 — no threshold. Donations are compared in your base currency, bits in bits." Donation platforms — "Unchecked — this widget ignores donations from that platform. New platforms are shown automatically."
5. Pick Content. It holds everything the card shows, kept together so that what is written is not scattered across the styling sections. Title text, Amount text and Message text are the three lines. Each starts as the built-in wording for your event and can be rewritten: the chips under a field insert {user}, {amount}, {currency} and {message} at the cursor, and the preview follows as you type. A variable the event has no value for — an amount on a follow — comes out empty rather than as a dash. Clear a field and that line goes away altogether. Image is a list of pictures you have added, with No image at the top. Add image… opens the system window; the app copies the file into its own folder, so OBS finds it even when it runs on a second computer. Open folder shows that folder in Explorer — that is where you delete pictures you no longer need.
6. Pick Behavior — the other half, how the card is shown. Group decides which group — and so which OBS link — shows this widget: "Each group has its own OBS link. Widgets of one group appear in the same spot and wait for each other." Alert Duration (sec) takes 3 to 30, and it is counted after the alert has appeared — the fly-in is not taken out of it. Appear animation, While shown and Disappear animation are three lists. The first and the last offer sliding from any side, fading, popping, zooming, shrinking or No animation; the middle one runs the whole time the card is on screen — pulse, float, sway, breathe, glow, shake, or Stand still, which is the default. Switch the scene to the Test tab and press Play to watch all three in a row. Sound is a list with No sound at the top, and every file shows its length next to the name: "Files come from the sounds folder — «Settings → Sound» in the app." Sound Volume is the slider.
7. The rest of the left column is the look: Backdrop, Alert Title, Amount / Event, Donor Message. Colours, fonts, sizes, borders and shadows of each part open on the right and show up in the preview immediately. Border Effect in the Backdrop group turns the card outline into a live electric one — a jagged, glowing line around the card. Effect Color, Effect Speed and Effect Chaos sit beside it; chaos is how far the line is thrown off the edge. It runs only while the alert is on screen. Amount / Event and Donor Message carry the same text controls as the title: font, text case and letter spacing, and the message has a font weight of its own. Each of the three lines has its own alignment — Title Alignment, Amount Alignment and Message Alignment — with Left, Center and Right to choose from. New widgets start centred, which is how alerts have always looked in OBS; the preview follows the same setting now, so what you set is what goes on stream.
8. Styling at the top of that column changes the whole look at once — the built-in Cyberpunk, Minimal, Retro, plus templates of your own. Apply applies the chosen one; the name field with Save stores the current look as your template. Picking one of your own templates puts its name into that field, and the button turns into Update: saving then goes back into that template instead of making a copy. Type a different name and it becomes Save again.
9. The scene above has two tabs. Preview keeps the card on screen at all times — that is the one to set colours and fonts against, because a card that slides away mid-edit would get in the way. Test starts as an empty window, the way an OBS source looks before an event; Play runs the whole show with the chosen sound and leaves the window empty again. − and + beside them zoom the scene.
10. Press Save. Name, event, behaviour and look are all stored by that one button — Back to list leaves without storing. Reset Customization drops the look you set.
11. In the list every widget row has a switch (Enabled), a play button, Duplicate, Delete and Configure. The play button shows that alert in OBS for real — the event travels the same way a live donation does, queue and sound included. It is not the same as the Test tab in the editor, which only animates the preview. If the group's link is not open as a Browser Source there is nobody to show it to, and the app says so in the log console.
12. The group header holds the link and the Copy URL button — that is what goes into a Browser Source in OBS. The group name is edited right there in the header.
13. Create group adds a second spot on the screen with its own link. From two groups on, the arrows Raise priority and Lower priority order them: "The higher the group, the more important: its alert jumps ahead of those waiting from lower groups. An alert already playing is never cut off." Own queue takes a group out of the shared waiting line — "its alert can play at the same time".
14. Delete group asks first and moves the widgets of that group into the one that remains; the deleted group's link stops working, so remove it from OBS.

What it cannot do

• Play on the Test tab stays on this page: it animates the scene, and nothing reaches OBS. The play button in the widget list is the one that does reach OBS.
• The animation while the card is shown cannot be timed by hand — each option has its own rhythm, and the card keeps it for as long as the alert is on screen.
• One event gives one alert per group — the most specific matching widget wins. The order inside a group is not set by hand: "Checked top to bottom: widgets with a higher amount threshold go first. The order is arranged automatically."
• Not every event comes from every platform, and the list says so. Follows and raids arrive from Twitch only; subscriptions and gifted sub drops from Twitch and YouTube; channel point rewards from Twitch and Kick; donations from almost everywhere. This is not the app holding back: YouTube has no notification for a new free subscriber at all — its webhook only reports videos — and Kick knows subscription as a chat badge, not an event. A paid YouTube membership does arrive, because it is announced in the chat.
• Emotes and Bits badges are drawn as pictures. Bits are sent as a word inside the message — "Thanks Cheer100" — and the alert shows the badge the viewer picked instead of that word: grey for one bit, then purple, green and the rest by amount, plus your channel's own badges if it has any. Channel emotes and YouTube Super Chat emotes are drawn the same way.
• Minimum amount and Donation platforms only exist for money: with donations and bits unticked, both fields are hidden.
• Both the sound and the image are picked from a list; a link of your own cannot be typed in. A link saved before the picker appeared stays in the list and keeps working.
• Pictures live in one folder shared by every alert. Deleting one there removes it from the alerts that used it, and those alerts show no picture until you pick another.
• SVG files are not accepted — only PNG, JPEG, GIF, WebP and AVIF.
• Alert Duration (sec) takes nothing below 3 or above 30.
• Where the alert sits on screen and how large it is come from the Browser Source in OBS — this page has no position or size fields.
• The last remaining group cannot be deleted.
• The page keeps no history of alerts that already played.