Ad Breaks.
Have the bot speak up around your ad breaks: a heads-up before they hit, a line the moment they start, and an all-clear when they finish. Your mods and a Stream Deck button can run or snooze ads too.
What ad breaks do
Twitch runs ad breaks on your channel, and this module lets the bot narrate them so chat is never left wondering. There are three independent messages | a pre-warn heads-up, an ads-started line, and an ads-finished line. Each one is off until you switch it on, and each can hold several variations the bot picks from at random.
The three messages
| Message | Fires |
|---|---|
| Pre-warn | A set number of seconds before a scheduled or automatic ad. |
| Ad started | The moment an ad break begins. |
| Ad finished | When the break ends, timed to the ad length. |
Give any message a few variations and the bot rotates through them, so your chat does not see the same line every break. Every message can use the same variables your commands can, for example $(ad.duration) or $(ad.nextin).
Pre-warn
Choose how many seconds before the ad the heads-up posts. To keep the bot from talking to a room that will not see ads anyway, you can require a minimum number of non-subscribers to have chatted in the last 60 seconds or so before it warns, or leave that at 0 to always warn. The pre-warn reads your ad schedule, so $(ad.nextin) fills in with the real countdown.
Skip short breaks
Quick bumpers are not worth announcing. Set a minimum ad length and the bot stays silent on any break shorter than it. Set it to 0 to announce every break.
Mod commands
Turn this on to let chat run or snooze ads without you tabbing out. Starting and snoozing ads on your behalf needs your permission, so authorize ad controls once from the page and it grants the two Twitch ad scopes. Then pick a default length for !ad and who is allowed to use the commands.
| Command | Does | Who |
|---|---|---|
!ad [seconds] | Start an ad break, using your default length when no number is given. | Your choice (default broadcaster) |
!snoozead | Push the next scheduled ad back. | Your choice (default broadcaster) |
The permission runs from broadcaster only, up to lead moderators, up to all moderators. The broadcaster always has access.
Self-trigger URL
Build a copy-paste URL to bind to a Stream Deck button or a hotkey, so you can fire an ad as you step away. Pick the action (run or snooze), a length, and whether it announces a break message in chat. The URL carries a private token, so treat it like a password.
The announce option uses its own set of break messages, separate from the !ad command. That way your "quick break, back soon" line only fires when you trigger it yourself, not every time a mod runs an ad.
Variables
| Token | Fills in with |
|---|---|
$(channel) | Your channel name. |
$(ad.nextin) | Time until the next scheduled ad, e.g. "2m 30s" (pre-warn). |
$(ad.duration) | The current or last ad length, beautified, e.g. "1 min 30 secs". |
$(ad.lastago) | Time since the last ad ran, e.g. "12m". |
$(ad.snoozecount) | Snoozes you have remaining. |
$(ad.prerollfree) | Seconds of pre-roll-free time left, where new viewers skip the opening ad. |
Like every module, ad break messages only post when the bot is enabled for your channel. Flip the chatbot on, then switch on the events you want.