TWITCH ONLY Designed specifically for Twitch. Not compatible with other platforms. DLL REQUIRED This extension requires a .dll file (TawmaeUI.dll) in your Streamer.bot directory. On your first setup, it will ask to auto-download. You can download it manually at tawmae.xyz/dll.

An all-in-one solution to moderate your Twitch streams with Streamer.bot. Prevent spam bots, deal with follow bot attacks and hate raids - and give your mods handy tools to manage your stream.

  • Bot Protection
    • Detect 'Cheap Viewers' bots and follow bot attacks
  • URL Filter
    • Block links, maintain a whitelist, permit users
  • Spam Filter
    • Blacklist words, filter ASCII, emote- and caps spam
  • Channel Management
    • Manage title, category, rewards, polls and predictions
  • Custom Commands
    • Quickly add commands or counters via chat
  • OBS Control
    • Change scenes, refresh sources or emergency-stream-end
MOD TOOLS Showcase 1MOD TOOLS Showcase 2

Quick Access

Copy what you need to get started. Follow the setup guide below for detailed instructions.

Action Import String

Import the actions into Streamer.bot.
Loading…

Setup Guide

1

Copy the Action Import String

Copy the Action Import text from Quick Access.

2

Import the actions into Streamer.bot

In Streamer.bot click Import in the top menu. Paste the text into the Import String field. Click Import at the bottom.

3

Enable the commands

Open the Commands tab. Find the imported group. Right-click the group and click Enable All.

4

Open the Settings UI once and hit Save

Open the action [MOD TOOLS] [#] 1 - Settings. Right-click the Test trigger and hit Test Trigger. Click Save.

If the TawmaeUI.dll is missing, you'll be asked to auto-download. That popup window may appear behind the Streamer.bot window, so make sure to check if nothing appears.
5

Done!

You can now customize everything to your liking!

Settings UI

General

Configure core behavior such as reply style, shared chats, emote-only behavior and translation language.

  • Post Messages As Replies
    Toggle whether chat responses are posted as replies or regular chat messages. Also allows whispering commands to broadcaster/bot and receiving whisper responses.
  • Ignore Shared Chats
    Ignore commands and messages coming from shared chats that are not originating from your own channel.
  • Emote-Only On Stream End
    Automatically enable emote-only mode when the stream ends and disable it again once you go live.
  • Translation Language
    Choose the target language for the !translate command from a list of supported languages (English, German, French, Spanish, etc.).

URL Filter

Toggle and customize your URL filter, whitelist URLs and users, and define consequences for unpermitted links.

  • Block Links
    Prevent links from being posted to chat unless they are explicitly whitelisted or the user is allowed.
  • Whitelisted URLs
    Add base URLs that are allowed to be posted by anyone (e.g. twitch.tv, youtube.com). Also manageable via commands.
  • Permit Duration
    Configure how long (in seconds) a !permit [User] lasts, during which the user can post links.
  • Allow VIPs
    Let VIPs post links without being blocked by the URL filter.
  • Allow Subscribers
    Let subscribers post links without being blocked by the URL filter.
  • Allow Followers
    Allow followers with a minimum follow age in days to post links. 0 disables the min-follow requirement.
  • Warn User
    Post a warning message to users who post unpermitted links. Ignored if timeout is enabled as well.
  • Timeout User
    Optionally timeout users for a configurable duration when they post unpermitted links.
  • Whitelisted Users
    Add specific usernames that are always allowed to post links, regardless of other URL filter rules.

Bot Protection

Protect your channel from spam bots and follow bot attacks, and configure automatic countermeasures.

  • Ban Sale Bots
    Automatically ban bots trying to sell viewers or similar services in their first message.
  • Ban Discord Bots
    Automatically ban bots that ask to be added on Discord in their first message.
  • Auto-Enable Follow Attack Protection
    Automatically enter protective mode once a follow bot attack is detected.
  • Remove Botted Followers
    Automatically remove botted followers while follow attack protection is active.
  • Protective Mode Duration
    Set how long (in seconds) the follow attack protective mode stays active once enabled.
  • Actions To Disable
    Select actions (e.g. follow alerts) that are disabled during a follow bot attack.
  • Action Queues To Pause
    Select action queues that will be cleared and paused during a follow bot attack.
  • Pause All Channel Rewards
    Pause all Streamer.bot-owned channel point rewards for the duration of the attack.
  • Clear TTS
    Clear the TTS queue in Speaker.bot once a follow bot attack starts.
  • Disable All Browser Sources
    Disable all browser sources in OBS for the duration of the attack.
  • Follow Amount Threshold
    Number of follows that must occur within the configured time window to trigger protective mode.
  • Duration Threshold
    Time window in seconds during which the follow threshold must be met to trigger protective mode.
  • Send Data After Attack
    Send a list of known bot accounts from the attack to a public GitHub repository to improve global protection. Contains only bot data, no personal user data.

Spam Protection

Handle suspicious users, blacklisted words, and caps/emote/ASCII spam with configurable consequences.

  • Suspicious Users Overlay
    Link to a browser/OBS dock to quickly moderate new chatters and accounts younger than 90 days via WebSocket.
  • Consequence
    Choose what happens on infringement: delete only, warn, timeout, or ban.
  • Timeout Duration
    Timeout duration (in seconds) used when 'Timeout' is selected as the consequence.
  • Bypass Moderators
    Ignore spam checks for messages sent by moderators.
  • Bypass VIPs
    Ignore spam checks for messages sent by VIPs.
  • Bypass Subscribers
    Ignore spam checks for messages sent by subscribers.
  • Filter Blacklisted Words
    Enable automatic filtering of messages containing blacklisted words.
  • Blacklisted Words
    Manage a list of words that will be filtered out of chat when detected.
  • Replace Bad Word
    Optionally repost the filtered message with the blacklisted word replaced by a placeholder such as [REDACTED].
  • Allow Moderators (Blacklisted Words)
    Let moderators use blacklisted words without their messages being filtered.
  • Allow VIPs (Blacklisted Words)
    Let VIPs use blacklisted words without their messages being filtered.
  • Caps Protection
    Toggle caps protection and set the allowed maximum of consecutive capital letters per message.
  • Emote Protection
    Toggle emote protection and set the allowed maximum number of emotes per message.
  • ASCII Protection
    Block chat messages that contain ASCII spam patterns.

Hate Raid Protection

Configure how your channel reacts when you enable hate raid protection during a toxic or hostile raid.

  • Clear Chat
    Automatically clear the chat when hate raid protective mode is enabled.
  • Follower-Only Mode
    Automatically enable follower-only mode with a minimum follow duration in minutes when protection is enabled.
  • Sub-Only Mode
    Automatically enable sub-only mode when protection is enabled.
  • Emote-Only Mode
    Automatically enable emote-only mode when protection is enabled.
  • Slow Mode
    Automatically enable slow mode with a configurable interval in seconds.
  • Pause All Channel Rewards
    Automatically pause all Streamer.bot-owned channel rewards while hate raid protection is active.
  • Clear TTS
    Automatically clear all pending TTS requests in Speaker.bot when protection is enabled.
  • Disable All Browser Sources
    Disable all OBS browser sources while hate raid protection is active.
  • Actions To Disable
    Select actions that will be temporarily disabled during the protective mode.
  • Action Queues To Pause
    Select action queues that will be cleared and paused during the protective mode.

Raids & Shoutouts

Manage shoutouts as well as behavior for incoming and outgoing raids.

  • Send Twitch Shoutout
    Send the built-in /shoutout command in addition to the custom chat message. Requires you to be live and respects Twitch's 3-minute cooldown.
  • Snooze Ads On Incoming Raid
    Automatically snooze upcoming ads when a raid comes in, if snoozes are available.
  • Auto-Shoutout On Raid
    Automatically shout out incoming raiders when they raid your channel.
  • Followed Only Auto-Shoutout
    Restrict automatic shoutouts to raiders that you already follow.
  • Minimum Raid Viewers
    Only auto-shoutout incoming raiders if they bring at least this number of viewers.
  • Post Sub Raid Message
    Automatically post a preconfigured raid message for subscribers when you raid out.
  • Post Non-Sub Raid Message
    Automatically post a preconfigured raid message for non-subs when you raid out.
  • Post Sub Raid Message As Broadcaster
    Choose whether the sub raid message is posted as the broadcaster account or the bot account.

Chat Management

Configure default durations for polls and predictions and behavior of custom commands.

  • Default Poll Duration
    Fallback duration (in seconds) used when a poll is created without an explicit duration.
  • Default Prediction Duration
    Fallback duration (in seconds) used when a prediction is created without an explicit duration.
  • Show Permitted Commands Only
    When listing all custom commands via !customCommands, only show commands the requesting user has permission to use.

OBS Management

Control how scenes are listed and manage scene exclusions for OBS-related commands.

  • Scenes In One Message
    If enabled, post all scenes in a single chat message; otherwise one scene per line for readability.
  • Whisper Scenes
    Send the list of scenes as a whisper instead of a public chat message. Falls back to chat if whispers fail.
  • Excluded Scenes
    Select scenes that should be excluded when listing or managing scenes via commands.

Super Moderators

Designate super moderators and restrict certain powerful features to them only.

  • Super Moderators
    Choose moderators that are granted super moderator status, allowing them to timeout and ban other moderators.
  • Channel Reward Management (Super Mods Only)
    Restrict channel point reward management to super moderators only.
  • OBS Management (Super Mods Only)
    Restrict OBS-related commands and management to super moderators only.

Chat Responses

Customize chat responses for this extension. Allows disabling or overriding text for each event.

  • Per-Event Messages
    Edit the text for each chat response triggered by the extension's actions.
  • Disable With Hyphen
    Enter a single hyphen (-) as the message to disable that specific chat response entirely.
  • Reset To Default
    Use the reset icon next to each textbox to restore the default message for that response.
  • noMessage Argument
    Optionally suppress a single reply by setting a noMessage argument to True via a Set Argument subaction.

Commands

Channel Management

Mods Only

!setTitle [Title]

Set a channel title.

!setTitle This is a super cool channel title | !sr !commands
Mods Only

!setGame [Game]

Set the channel game/category.

!setGame Witcher 3
Mods Only

!addTag [Tag]

Add a channel tag.

!addTag LGBTQFriendly
Mods Only

!removeTag [Tag]

Remove a channel tag.

!removeTag Calm

Custom Commands

Mods Only

!addCommand [!command] [Command Text]

Add a custom text command.

!addCommand !bluesky Check out my Bluesky profile: https://bsky.app/profile/tawmae.xyz
Mods Only

!editCommand [!command] [Command Text]

Edit a custom text command.

!editCommand !bluesky Follow me on Bluesky: https://bsky.app/profile/tawmae.xyz
Mods Only

!removeCommand [!command]

Remove a custom command.

!removeCommand !bluesky
Everyone

!customCommands

Show all custom commands.

!customCommands

OBS Management

Mods Only

!scenes

List all OBS scenes.

!scenes
Mods Only

!setScene [Scene Name]

Set a specific OBS scene by name or index.

!setScene Gaming
Mods Only

!refreshAudio

Refresh all OBS Application Audio Capture sources.

!refreshAudio
Mods Only

!refreshBrowserSources

Refresh all OBS Browser Sources.

!refreshBrowserSources
Mods Only

!endStream

End the stream (double-confirmation required).

!endStream

Chat Management

Mods Only

!shoutout [Username]

Post a shoutout in chat.

!shoutout tawmae
Everyone

!translate [Text]

Translate a given text. Works as a reply too.

!translate Hallo, guten Tag.
Mods Only

!timeout [Username] <Duration>

Timeout a user. Duration optional, must use <>.

!timeout tawmae <120>
Mods Only

!ban [Username]

Ban a user. Reason optional.

!ban tawmae
Mods Only

!runAds [User] [Duration]

Run an ad for 30–180 seconds. Defaults to 180.

!runAds 120
Mods Only

!prerollTime

Post remaining preroll-ad-free time.

!prerollTime
Mods Only

!snoozeAd

Snooze the next upcoming ad.

!snoozeAd
Mods Only

!skipTTS

Skip currently playing TTS in Speaker.bot.

!skipTTS
Everyone

!modCommands

Send this website's commands tab into chat.

!modCommands

URL Filter

Mods Only

!permit [User]

Permit a user to post links for a limited time.

!permit tawmae
Mods Only

!addURL [URL]

Add a link to the whitelist.

!addURL twitch.tv
Mods Only

!removeURL [URL]

Remove a link from the whitelist.

!removeURL twitch.tv
Mods Only

!urlAddUser [Username]

Whitelist a user for URLs.

!urlAddUser tawmae
Mods Only

!urlRemoveUser [Username]

Remove a user from the URL whitelist.

!urlRemoveUser tawmae
Mods Only

!urlFilter

Toggle the URL filter on/off.

!urlFilter
Everyone

!whitelistedURLs

Show all whitelisted URLs.

!whitelistedURLs

Bot & Hate Raid Protection

Mods Only

!enableFollowAttackProtection

Enable follow bot attack protection.

!enableFollowAttackProtection
Mods Only

!disableFollowAttackProtection

Disable follow bot attack protection.

!disableFollowAttackProtection
Mods Only

!removeBottedFollowers

Remove botted followers from a registered attack.

!removeBottedFollowers
Mods Only

!removeLatestFollowers [Minutes]

Remove all followers within the last X minutes. Double-confirmation required.

!removeLatestFollowers 15
Mods Only

!hateRaid

Toggle hate raid protection.

!hateRaid

Spam Filter

Mods Only

!banWord [Word]

Add a word to the blacklist.

!banWord asshat
Mods Only

!unbanWord [Word]

Remove a word from the blacklist.

!unbanWord asshat
Mods Only

!toggleBlacklistedWordsFilter

Toggle blacklisted-words filter.

!toggleBlacklistedWordsFilter
Mods Only

!toggleCapsProtection

Toggle caps filter.

!toggleCapsProtection
Mods Only

!toggleEmoteProtection

Toggle emote filter.

!toggleEmoteProtection
Mods Only

!toggleASCIIProtection

Toggle ASCII filter.

!toggleASCIIProtection

Channel Point Rewards

Mods Only

!enableReward all / [Group] / [Reward]

Enable all, a reward group, or a single reward.

!enableReward Hydrate
Mods Only

!disableReward all / [Group] / [Reward]

Disable all, a reward group, or a single reward.

!disableReward Hydrate
Mods Only

!pauseReward all / [Group] / [Reward]

Pause all, a reward group, or a single reward.

!pauseReward Hydrate
Mods Only

!unpauseReward all / [Group] / [Reward]

Unpause all, a reward group, or a single reward.

!unpauseReward Hydrate
Mods Only

!rewardTitle [Reward] <New Title>

Change reward title. Title must be in <>.

!rewardTitle Hydrate <Hydrate Me!>
Mods Only

!rewardPrompt [Reward] <New Prompt>

Change reward prompt. Must be in <>.

!rewardPrompt Hydrate <Make me chug a glass of water.>
Mods Only

!rewardCost [Reward] <New Cost>

Change reward cost. Must be in <>.

!rewardCost Hydrate <500>
Mods Only

!rewardCooldown [Reward] <New Cooldown>

Change cooldown in seconds. 0 disables. Must be in <>.

!rewardCooldown Hydrate <300>
Mods Only

!rewardMaxPerStream [Reward] <New Max>

Change max redemptions per stream. 0 disables.

!rewardMaxPerStream Hydrate <10>
Mods Only

!rewardMaxPerUserPerStream [Reward] <New Max>

Change max redemptions per user. 0 disables.

!rewardMaxPerUserPerStream Hydrate <3>

Polls & Predictions

Mods Only

!createPoll [Title] | [Duration] | [Option 1] | ...

Create a Twitch poll. Duration optional (seconds).

!createPoll What should we play next? | 180 | Borderlands 4 | The Witcher 4 | Resident Evil 9 | Alien Isolation 2
Mods Only

!endPoll

End active Twitch poll.

!endPoll
Mods Only

!createPrediction [Title] | [Duration] | [Option 1] | ...

Create a Twitch prediction.

!createPrediction Will we survive until 6 PM? | 180 | Yes | No
Mods Only

!lockPrediction

Lock the active prediction.

!lockPrediction
Mods Only

!resolvePrediction [Option Title / Number]

Resolve prediction by title or option number.

!resolvePrediction Yes
Mods Only

!cancelPrediction

Cancel the current prediction.

!cancelPrediction

OBS Docks

Streamer.bot WebSocket Requirements

For all docks to work, you need to enable the WebSocket server in Streamer.bot.
Go to the tab Servers/Clients → WebSocket Server and make sure:
  • Address is set to 127.0.0.1
  • Port is set to 8080
  • and the server is running.

User Chat Log

User Chat Log dock shows the latest chat messages of a specific user.
You can open it in a browser or dock it directly into OBS.
Because it relies on Streamer.bot, it only captures messages while Streamer.bot is running and connected to Twitch.
It also displays profile picture, account age, and user roles.
Docking URL: https://tawmae.xyz/overlays/mod-tools-user-chat-log
User Chat Log dock preview

Suspicious User Monitoring

Suspicious User Monitoring dock can be added directly to OBS as a browser dock.
It lists new chatters and accounts less than 90 days old and allows purge, timeout, or ban.
Useful for catching suspicious accounts early.
Docking URL: https://tawmae.xyz/overlays/mod-tools-user-monitoring
Suspicious User Monitoring dock preview

FAQ & Examples

Can I disable certain chat responses?
Yes. In the Settings UI under the Chat Responses tab, you can enter a single hyphen - as the message to disable that specific chat reply entirely.

You can also use a noMessage argument via a Set Argument subaction. If you set noMessage = True, the extension suppresses that one specific reply without disabling the entire configured message.

Changelog

v2.0.6 latest

  • Fix: Fixed an issue that prevented commands from working in 2.0.5

v2.0.4

  • Fix: Fixed the Auto-Shoutout toggle for raid messages not applying correctly.
  • Changed: Changed the design of the OBS docks.
  • Changed: Updated to the latest DLL version (v.1.5.6).

v2.0.3

  • Fix: Fixed a potential file lock issue for "User Chat Log".

v2.0.2

  • Fix: Fixed emote-only mode not toggling when activating hate raid protection.
  • New: Added new OBS dock "User Chat Log".

v2.0.1

  • New: Added 'Suspicious User Message' trigger to ban bots.
  • Changed: Updated requirements to Streamer.bot 1.0.0.alpha53+.
  • Changed: Updated requirements to DLL version 1.4.1+.
  • Changed: Changed UI chat responses to include reset buttons.

v2.0.0

  • New: Initial 2.0.0 release.

User Reviews

5.0 (5 reviews)

Reviews

this guy does not miss, what a legendary collection of tools knowing exactly what streamers need, with incredible customization but also easy initial setup (that goes for basically everything here)

Very helpful! Coming from MIU, this really helped me get my bot into a more than usable state again. Thanks Tawmae!

To date, I have blocked over 20 bots in just a span of a month (in total) streaming! Now I have more time to make fun of them!

Must Have für jeden Stream! Habe mich solange gedrückt mich hin zu setzen und es einzurichten bereue jede Minute die ich ohne gestreamt habe :)