Alerts

Comes with strAImer: this module is installed together with the app, so there is nothing to download. It is listed under Module Catalog → Built-in.

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: an exact amount first, then the range with the higher lower limit, then the narrower one."
4. With donations or bits ticked, two more fields appear. Amount is a list: Any amount, From, Up to, Between or Exactly, with one or two number fields next to it. "Donations are compared in your base currency, bits in bits. Both limits are included, so give neighbouring ranges a shared limit (up to 100 and from 100) to leave no gap." Exactly is matched to the cent, so a donation converted from another currency will rarely hit it. 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.
6. Pick Media. Everything the card shows or plays is chosen here: the picture, the video and the sound. The picture and the video share the tab because one replaces the other. Image is a slot that shows the chosen picture, or No image. Click it and the Choose an image window opens: Library holds what is already in strAImer, and Folders holds the folders you have opened. Any folder works, and you do not need to move anything: Open folder… asks you to pick any file in it, and the whole folder joins the list with that file selected. The app copies the file you choose into its own folder, so OBS finds it even when it runs on a second computer, and the same file is never copied twice. The cross beside the slot (Remove) clears it. Video is the same kind of slot for clips. A video brings its own sound, so while one is set the Sound slot further down this tab is greyed out with "The sound comes from the video." Anything that is not webm is converted when you choose it, because the OBS browser source cannot play mp4: the window marks such files Becomes WebM, and the button reads Convert and choose. Conversion runs in real time, so a ten-second clip takes about ten seconds, and five minutes is the limit; a longer clip is refused with "Could not convert this video. Try another file." The card then stays up for whichever is longer, your Alert Duration (sec) or the video itself, and the queue counts that same length, so the next alert does not cut in over a clip that is still playing. Sound and Sound Volume are on this tab too. Sound is a slot with a ▶ button to listen, and it shows the file's length; click it and the Choose a sound window opens. Sound Volume is the slider, and ▶ plays at that level. The copies are kept in %APPDATA%\straimer\images and %APPDATA%\straimer\videos, and that is where you delete files you no longer need: this page has no button that opens those folders, and Open folder… in the window adds a folder to its list rather than opening Explorer. An alert whose file was deleted shows it as missing in its slot until you choose another.
7. 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.
8. The rest of the left column is the look: Placement, Backdrop, Material, Outline effect, 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. Placement decides where the card stands inside the Browser Source and how wide it is. Horizontally is Left edge, Centre or Right edge; Vertically is Top edge, Centre or Bottom edge. Gap from top and bottom and Gap from left and right move the card away from that edge, in pixels. Card width is either Fixed, as wide as the source up to the limit, or Grows with the text, so a short donation gets a short card. Width limit starts at 600 px, and the card never gets wider than it: a Browser Source wider than the limit only leaves empty room beside the card. To widen the card, raise Width limit. Material, right under Backdrop, draws the card in one of twelve styles. When the alert has a picture or a video, it also draws a rim of the same style around it: a pencil outline, a stepped frame, a gilded edge, a glass rim. Media frame width in Material sets that rim from 4 to 32 px. Under a material, Border in Backdrop is hidden, and Shadow and Glow too for some of them, because the material draws its own edge. Outline effect runs one of ten effects around the card; under Plays, On event flashes it as the alert appears. The electric border is the first of them, Electric, with Effect color, Effect speed and Effect chaos; chaos is how far the line is thrown off the edge. It used to be Border Effect in Backdrop, and a widget that had it on keeps it: the app moves it into Outline effect once, with the same colour, speed and chaos. How materials and effects work in every overlay is in Styling an Overlay. 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. Media look and Media frame appear once a picture or a video is set: its size, how it is fitted, which side of the card it stands on or whether it sits inside, plus a backing, an outline, a shadow and an effect of its own. Effect in Media frame offers the same ten effects as Outline effect, chosen apart from the card's, each with its own colour and speed, playing all the time or as the alert appears. Under a material, Backing, Inner padding, Outline and Shadow of Media frame are hidden: the material draws the rim instead. Size is either Set by hand or Fill the card. On Fill the card, Width, Height and Fitting are hidden. With Size on Set by hand, a Link width and height switch sits under Width. It is on by default, so moving one side moves the other in the same proportion, typed numbers included. Turn it off to change one side alone; it is on again the next time the page is opened.
9. Styling at the top of that column changes the whole look at once: the built-in Neon, Minimal, Retro, twelve looks named after the materials, 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.
10. 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.
11. Press Save. Name, event, behaviour and look are all stored by that one button. Back to list with unsaved changes first asks, under the title "Changes not saved": Leave drops them, Stay keeps you in the editor. Reset Customization brings the default look back in the editor; it is stored only by Save, and leaving without saving keeps the look you had.
12. In the list every widget row has a switch (Enabled), a play button (Show in OBS), 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. A widget switched off answers no events, and the event goes to the next matching widget of the same group instead, with that widget's sound. To keep an event off screen, switch off every widget that matches it, or the whole group. Switching a widget off, deleting it or moving it to another group also drops its alerts already waiting in the queue, without a card or a sound, and so does switching off or deleting its group. An alert already on screen plays to the end. The play button still plays a switched-off widget, so you can check its look before switching it on.
13. Groups look like folders. A click on the group header, or on the arrow at its left, collapses and expands it, and the number next to the name is how many widgets it holds. The name is edited right there in the header. On the right of the header are the priority arrows, the group switch (Group on) and Delete group.
14. Under the header of an open group is a row of buttons. Copy link puts the group's link on the clipboard, and that is what goes into a Browser Source in OBS: the address itself is not shown on the page. Design opens one editor for the whole group: backdrop, material, outline effect, title, amount, message and media frame. It applies only what you changed there, and asks first, naming the sections. + adds a widget straight into this group, and the last button copies the group with all its widgets. The copy starts switched off and has its own link.
15. The group switch silences the whole group without touching the widgets' own switches: "The group is off: none of its widgets play. "Show in OBS" still works for checking."
16. 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". The shared line also waits for Voice Over: when it reads a donation, the next alert starts once the line is finished. A group with Own queue does not wait for it.
17. 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: the higher the lower amount limit, the higher the widget, and with the same lower limit the narrower one goes first. An exact amount always beats any range it falls into. 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.
• Amount and Donation platforms only exist for money: with donations and bits unticked, both fields are hidden.
• There is no picking one channel point reward. A widget with channel point rewards ticked answers every redemption of every reward on the channel. Subscriptions are not split by tier either: one widget takes Tier 1, Tier 2, Tier 3 and Prime alike.
• The page does not show the OBS link as text. Copy link is the only way to get it.
• The image, the video and the sound are chosen in a window; a link of your own cannot be typed in. A picture link saved before the window appeared stays and keeps working, and its slot marks it Web link. A sound linked from a website does not play on stream, and its slot says so: "A sound from a website does not play on stream. Choose a file."
• 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.
• The card moves only inside its Browser Source. Where that source sits in the scene and how large it is are set in OBS; Placement then pins the card to an edge or the centre of it.
• The last remaining group cannot be deleted.
• The page keeps no history of alerts that already played.