13 topics

OBS overlays and alerts

With the OBS overlays, SlakBot puts your Twitch alerts, counters with a goal bar, your Twitch chat, a giveaway wheel and your Spotify track on your stream. You set everything up on the OBS overlays page of the panel. Then you add each overlay to OBS as a browser source. Note: this page is still in closed beta. If you see a lock, you can request access. The Twitch alerts, the chat overlay and the giveaway wheel run through the SlakBot Twitch Chat-bot. That is also still in closed beta and has to be connected.

Access (closed beta)

Where to find it: Panel β†’ OBS overlays

The OBS overlays are still in closed beta. Only servers and admins that SlakBot has added itself can use the page. Everyone else sees the "πŸ”’ Closed beta" card with a "Request access β†—" link that goes to support.

Steps

  1. Open the OBS overlays page in the panel.
  2. Do you see "πŸ”’ Closed beta"? Click "Request access β†—".
  3. Once you have access, the "πŸŽ₯ Live in 3 steps" card appears at the top.
Note
  • Only server admins can open this page. The Twitch mod view says: "Not available in the Twitch mod view."
  • Follows, subs, gift subs, bits, raids, the Hype Train, the chat overlay and entering the wheel all come in through the SlakBot Twitch Chat-bot. That page is also in closed beta. If your Twitch Chat-bot is not connected, those alerts don't come in.

Adding the overlay to OBS

Where to find it: OBS overlays β†’ πŸŽ₯ Live in 3 steps

Your alerts run on one secret overlay link, which you paste into OBS as a browser source. The panel shows whether OBS is connected.

Steps

  1. Next to "Copy your secret overlay link", click πŸ“‹ Copy.
  2. In OBS, go to Sources β†’ βž• β†’ Browser and paste the link. Set the width to 1920 and the height to 1080, and place the source above your game layer.
  3. In that same OBS window, untick "Shutdown source when not visible".
  4. Check that it says "🟒 OBS is connected" and test with the buttons after "▢️ Test:".
  5. Nothing showing, or did you save a change? Right-click the source in OBS β†’ Refresh.
Note
  • If you leave "Shutdown source when not visible" ticked, you miss every alert while you are on another scene.
  • The link is secret. Don't share it with anyone and never show it on stream. With the link, someone can view your overlay and play test alerts on it.
  • Your alerts and the milestone alerts appear on this link. The stat counters, chat overlay, giveaway wheel, Now Playing and custom code each have their own link. Add each one as a separate browser source.

Testing, live preview and replay

Where to find it: OBS overlays β†’ πŸŽ₯ Live in 3 steps, πŸ“Ί Live preview and βͺ Recent alerts (replay)

The test buttons play a sample Donation, Sub, Gift subs, Bits, Raid, Follow, Hype Train, Video or Goal reached alert in OBS. The Live preview shows your real overlay inside the panel. It starts muted and only shows what you have saved. Recent alerts lists your last 40 real events, including ones from moments when OBS was not connected, and you can still play them.

Steps

  1. Optionally enter an amount after "▢️ Test:" and click an alert button.
  2. Under πŸ“Ί Live preview, click "β–Ά Start preview". To hear it, click the πŸ”‡ Sound off button.
  3. Always save a change first, because the preview only shows saved settings.
  4. Missed an alert? Under βͺ Recent alerts (replay), click β–Ά Replay.
  5. Done? Click ⏹ Stop preview.
Note
  • Does the panel say "No OBS connected"? Then the browser source is not (properly) set up in OBS yet.
  • A replay uses your current alert settings, not the ones from back then, and shows no viewer message.
  • Tests and replays are never read aloud.
  • A running preview keeps a connection to your overlay busy, so stop it when you are done.

Setting up alerts: tiers, text and colour per word

Where to find it: OBS overlays β†’ ✏️ Your alerts (click ✏️ to customize)

There are seven alert types: Donation, Sub, Gift subs, Bits, Raid, Follow and Hype Train. For each type you create one or more tiers, and each tier plays from a certain amount or count. Out of all tiers that fit, the highest one plays. If the amount is below your lowest tier, or you have not created a tier yet, SlakBot plays a plain default text without your media.

Steps

  1. Click ✏️ next to a type, then βž• New tier.
  2. Fill in "From how much" (1 = always) and type your text. {name} becomes the name. You add the number with {amount} for Donation, {months} for Sub, {level} for Hype Train and {count} for the rest. The Dutch names the panel shows ({naam}, {bedrag}, {aantal}, {maanden}) work too. If you leave the text empty, you get the default text.
  3. Colour per word: click a word and pick a colour. 🚫 removes all colours.
  4. Optionally set a subtitle, πŸ˜€ Emoji, πŸŽ‰ Confetti, Duration, Volume and "Motion & sound".
  5. Click πŸ’Ύ Save, then "β–Ά Test this tier". After saving, you can drag text and media across the screen yourself with 🎨 Custom editor.
Note
  • These alerts fire by themselves on real follows, subs and resubs, gift subs, bits and raids. Someone who follows again within 12 hours gets no second follow alert.
  • The Hype Train only works after you click πŸ”„ Reconnect on the Twitch Chat-bot page. Donations only work once you have connected StreamElements or Streamlabs: go to the Supporters page β†’ πŸ’Ά Connect tips and switch on "Process tips".
  • A sub tier counts in months: for a resub, the total number of months counts. With gift subs, only the gifter gets an alert. For donations, the amount counts in whole euros.
  • Colour per word only works on your own text, not on viewers' messages. Duration can be Auto or 3 to 90 seconds.

Your own media, variations and odds

Where to find it: OBS overlays β†’ ✏️ Your alerts β†’ open a tier

You can attach a video, GIF or image and a sound to each tier. You upload a file, or you paste a direct https link that ends in the file name, such as .mp4 or .mp3. With Variations you give a tier more media or sounds, and SlakBot picks one of them for each alert. If you leave the chance empty, every variation has equal odds. With numbers (for example 1 and 99) you create rare variants, and the panel works out the real percentage for you.

Steps

  1. Click πŸ“ Upload next to the media or sound field and pick a file, or paste an https link.
  2. Click βž• Add variation and fill in media and/or sound. Each variation also has its own πŸ“ button.
  3. Enter a chance in the % box, or leave everything empty for equal odds.
  4. Click πŸ’Ύ Save. An upload is only kept once you save.
Note
  • Allowed are GIF, PNG, JPG, WEBP, WEBM and MP4 for visuals, and MP3, OGG and WAV for sound. A media file can be up to 40 MB, a sound up to 10 MB. Each server has 250 MB of storage in total.
  • Variations only swap media and sound. The text stays the same.
  • Volume goes up to 200%. Above 100% the sound is amplified.
  • If you replace or clear an uploaded file and save, SlakBot removes the old file.

Appearance, coins and read aloud (TTS)

Where to find it: OBS overlays β†’ 🎨 Appearance (colors + font)

Here you pick the Accent color, Accent 2 (highlights), Text color and Font for all your alerts. Only fonts that come with OBS on Windows are listed. "Show awarded coins in the alert" adds "+X coins" to the alert when a linked viewer earns coins. "Read messages aloud (TTS)" reads out the bottom line of an alert, such as the message that comes with a donation or resub.

Steps

  1. Pick your colors and font.
  2. Optionally switch on "Read messages aloud (TTS)", fill in "Only donations from (€)" and pick a Voice language.
  3. Click πŸ’Ύ Save. Colors and font show up right away. After switching on read-aloud, refresh the source in OBS.
Note
  • By default, coins in the alert are ON and reading aloud is OFF.
  • Read-aloud does not work in every OBS version. If the browser source has no voices, it stays silent. So test it in OBS itself with a real donation or resub, because tests and replays are not read aloud.
  • Your own subtitle, the default line on a follow or Hype Train (for example "Welcome!" with your follower count) and "+X coins" are read aloud too. The minimum amount only applies to donations. A text is cut off after 200 characters.

Milestone alerts

Where to find it: OBS overlays β†’ 🎯 Milestone alerts (automatic)

SlakBot automatically shows a big "GOAL REACHED" screen when your follower or sub count passes a milestone, for example every 100 followers. It happens on the first follow or sub event after the milestone, as long as your overlay is open in OBS. The screen appears on your normal overlay link.

Steps

  1. Fill in "Celebrate every … followers" and/or "Celebrate every … subs" (0 = off).
  2. Enter a Title ({n} = the number reached) and optionally a Subtitle.
  3. Click πŸ’Ύ Save. You can try the look with the 🏁 Goal reached button at the top.
Note
  • OFF by default (0). After saving, SlakBot counts from your current total, so switching it on never gives a false milestone. After a big jump, SlakBot only celebrates the highest milestone.
  • Follower milestones need your Twitch Chat-bot to be connected. Sub milestones need your Twitch channel connected through the Twitch Sub Roles page.

Import from StreamElements

Where to find it: OBS overlays β†’ 🎁 Alerts β†’ πŸ“₯ Import from StreamElements

You can bring over your existing StreamElements alert box: the thresholds, media, sounds, duration and volume. The styling and animations do not come along. Media from StreamElements are copied to your own SlakBot storage. If your server is set to Dutch in SlakBot, you get SlakBot's default texts instead of your own StreamElements texts. In any other language, your own texts are carried over.

Steps

  1. Copy your JWT token from StreamElements (Account β†’ Show secrets), paste it under "Fetch with your SE token" and click πŸ”‘ Fetch. You can also paste the overlay JSON into the box below it.
  2. Click πŸ‘οΈ Preview to see which tiers were found.
  3. Click πŸ“₯ Import and confirm.
  4. Check your alerts and test them.
Note
  • Existing tiers with the same minimum amount are overwritten.
  • The token goes to SlakBot once to fetch your alerts and is not stored afterwards. Feel free to reset it in StreamElements afterwards.
  • Only the StreamElements alert box is imported. Importing alerts from Streamlabs is not possible.

Stat counters and goal bar

Where to find it: OBS overlays β†’ 🧩 Widgets (expand) β†’ πŸ“Š Stat counters

A separate overlay with cards for Followers, Subs, Bits (total), Latest follower, Latest sub and Latest bits, which updates live. For Followers, Subs and Bits you can set a goal. It then shows for example "43 / 100" with a progress bar.

Steps

  1. Copy the "Stats URL for OBS" and add it as a separate 1920Γ—1080 browser source.
  2. Under "Which counters to show", tick what you want to display. At least one has to be on.
  3. Under "Goals (optional)", enter a goal and choose whether to "Show progress bar".
  4. Under "πŸ“ Position & size on your overlay", drag the block to the right spot.
  5. Click πŸ’Ύ Save and refresh the source in OBS.
Note
  • By default all counters are on. If you want one big number without a card, switch on "Add a standalone plain counter" and add that link as a second browser source.
  • The follower counter works once your Twitch Chat-bot is connected. The sub counter needs your Twitch channel connected through Twitch Sub Roles. Without that connection you see "β€”".
  • The bits total only counts bits that SlakBot itself has received, so nothing from before you used the overlays. It does not reset per stream. A goal can be at most 100,000,000 and only works on a counter that is switched on.

Chat overlay

Where to find it: OBS overlays β†’ 🧩 Widgets (expand) β†’ πŸ’¬ Chat overlay (your Twitch chat on screen)

Put your Twitch chat on your stream as a separate browser source. Messages that SlakBot blocks or that look like a scam never appear on screen. If a mod removes a message, or gives a timeout or ban, it disappears from the screen too. Commands (messages starting with your command character, ! by default) and SlakBot's own messages never appear.

Steps

  1. Copy the "Chat URL for OBS" and add it as a separate 1920Γ—1080 browser source.
  2. Under "The box", set the Width and Height. Under "πŸ“ Position & size on your overlay", drag the block to where your chat should be.
  3. Under Colors, pick the Background, Text and Border, with "Background opacity" and "Border width". "πŸ«₯ Fully transparent" removes the background in one click.
  4. Set "Messages on screen", "Message disappears after", "Show rank" and "Twitch emotes as images".
  5. Click πŸ’Ύ Save and always refresh the source in OBS afterwards.
Note
  • By default up to 12 messages are shown, and they stay until new ones push them out. If you don't drag the block, the chat sits in the bottom-left corner.
  • Other bots, such as Nightbot or StreamElements, do show up on screen.
  • Emotes from BTTV, FFZ and 7TV show up as text, not as images.
  • Whatever appears here also ends up in your VOD and clips.

Giveaway wheel

Where to find it: OBS overlays β†’ 🧩 Widgets (expand) β†’ 🎑 Giveaway wheel

A spinning wheel for giveaways. Viewers enter by typing !join in your Twitch chat, and SlakBot confirms it in chat. You spin the wheel and the winner rolls into view.

Steps

  1. Copy the "Wheel URL for OBS" and add it as a separate 1920Γ—1080 browser source.
  2. Switch on "Giveaway on" and "Entries open", and under "Who can enter" choose Everyone, Subs, VIPs or Mods.
  3. Optionally add a name yourself with "Add a name manually…".
  4. Click "🎯 Spin the wheel". "πŸ—‘οΈ Clear" removes all entrants.
  5. Want to move the wheel? Drag the block and click "Save position".
Note
  • OFF by default, and entries are closed.
  • Each person can only enter once, and the wheel holds up to 1000 entrants. Someone who isn't allowed to enter or has already entered gets no reply in chat.
  • The winner stays in the list. Remove them with βœ• if you spin again. "Clear" cannot be undone.

Commands

!join (also !enter, !meedoen or !deelnemen) A viewer enters the giveaway wheel from your Twitch chat. Only works when "Giveaway on" and "Entries open" are switched on. If you set a command character other than ! on the Twitch Chat-bot page, use that one.

Now Playing (Spotify)

Where to find it: OBS overlays β†’ 🧩 Widgets (expand) β†’ 🎡 Now Playing (Spotify)

Shows your current Spotify track live on your stream, with album art, title and artist, and a progress bar. The color and font come from the 🎨 Appearance card.

Steps

  1. Click "🎡 Connect Spotify" and log in to Spotify.
  2. Copy the "Now Playing URL for OBS" and add it as a separate browser source (for example 460Γ—90).
  3. Under Display, choose "Always visible" or "Appears on every new song, then disappears". For the second option, also set "Disappears after (seconds)".
  4. Choose the "Corner on screen" and whether to show the album art and the progress bar.
  5. Click πŸ’Ύ Save and refresh the source in OBS.
Note
  • Do you see "The Spotify connection isn't switched on in SlakBot itself yet"? Then there is nothing you can do yourself. Ask at slakbot.nl/support.
  • βœ– Disconnect stops the Now Playing overlay.

Custom code (advanced)

Where to find it: OBS overlays β†’ βš™οΈ Advanced (expand) β†’ πŸ’» Custom code (advanced), and per tier under ✏️ Your alerts

This is for people who write their own HTML, CSS and JavaScript, like a custom widget in StreamElements. There are two ways. You can build your own overlay as a separate browser source with its own link. Or you can replace the standard alert card of a single alert tier with your own code.

Steps

  1. Switch on "Use custom code" and fill in HTML, CSS and JavaScript.
  2. Copy the "Overlay URL for OBS (custom code)" and add it as a separate browser source, next to your normal overlay link.
  3. Click πŸ’Ύ Save and refresh the source in OBS.
  4. For a single tier: open the tier, expand "Custom code (HTML/CSS/JS) Β· advanced", switch on "Use custom code for this tier" and click "πŸ’Ύ Save this code only".
Note
  • OFF by default. As long as it is off, nothing changes about your alerts.
  • Only paste code you trust. Your code sees the names and amounts of your alerts, and a mistake in it can freeze your overlay until you refresh the source.
  • Per-tier code is only possible after you have saved that tier once. When custom code is on, your 🎨 Custom editor layout is ignored for that tier. If you delete the tier, the code goes with it.