Skip to content

About

TwitchSentry is a full moderation suit built for streamer.bot and twitch.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

224 Commits

Folders and files

Repository files navigation

TwitchSentry

Your smart chat bodyguard. Built for Streamer.bot.

Platform: Twitch Tool: Streamer.bot MIT licence Latest stable release Latest pre-release Total downloads GitHub stars

Download · Manual · FAQ · Import String


Spam ruins the vibe. One minute you are reacting to a hilarious donation, the next your chat is full of fake gift links, sketchy URLs and copy-paste scams. TwitchSentry removes them, tells you why it was removed and from whom. And many more!


What it does

Action Function
Link Filter Blocks links from viewers you have not trusted, with a whitelist that matches exactly or by wildcard. Always on.
Spam Scoring Reads a message as an advert with parts — somewhere to go, something on offer, a way to redeem it, a signature — and acts when enough parts fit together. Always on.
Message Filter Watches how someone and who chats: account age, ALL CAPS, emote spam, flooding and repeats.
Raid Protection Arms itself after an incoming raid and watches for a swarm of accounts posting the same line.
Follow Protection Watches follows. It counts how many different accounts arrive inside a short window and judges each on age, avatar, profile and login.
Spam Learner Mines what was actually removed for new keywords, phrases and domain endings, and proposes them for review.
AutoMod Answers the messages Twitch's own AutoMod holds back, so nobody has to sit in the queue.
Twitch Warn Twitch's warning screen with escalation on top: warnings, a final warning, then a timeout, a ban or a restriction. Your moderators' own warnings can count too.
Permits A time-limited link exception for one viewer, granted by you, a moderator, or a Channel Points redeem.
Check Link Scans a URL with VirusTotal and IPQualityScore, either automatically or on !checklink.
Voting Lets chat vote someone out, with roles above VIP permanently unvotable.
Discord Alerts Posts everything that happened to a webhook to discord.
Windows Notifications A Windows notification for a new TwitchSentry release and various deck button actions.
Deck Buttons Switches profiles, modules, exemptions and test mode, arms Raid Protection or takes the last action back, from a Stream Deck key or a Streamer.bot Deck button.

Why not just Twitch's own AutoMod with SmartDetection?

Twitch's AutoMod reads messages for offensive language, and it is good at that. It has nothing to say about:

  • typos like hey.how or Super.Bis später, which it may hold back for nothing more than looking like a link.
  • forty accounts arriving on a raid and posting the same line.
  • hundreds of throwaway accounts pushing the follow button to corrupt your statistics.
  • the "your channel would look great with a logo" chat that only turns into a sales pitch on the fifth message.
  • the messages it does hold back, which sit in a queue until a moderator answers them one by one.

TwitchSentry covers all of those and more, and handles AutoMod's queue for you so nothing sits in it waiting on a moderator.


When something goes wrong

Ooops, the bot banned my best friend?!? — !tsundo takes back the last action, whichever module took it, and !tsundo @name reaches that viewer's most recent one. Every decision is also written down and readable in the window itself. The Action Log is what happened, the Violation Log is the message exactly as it was posted, the Clean Chat Log is the ordinary chat that was deliberately left alone, and the Status Log is TwitchSentry reporting on itself any errors, a download that failed, an action Twitch refused. More on the log pages →

Found a bug or have an idea? Report... in the ☰ menu opens a pre-filled GitHub issue, your setup included.

Languages

The settings window ships in English but you can download also: German, Spanish, French and Brazilian Portuguese, plus languages contributed by the community, switchable from the ☰ menu. What the bot says in chat is yours to write, in whatever language your channel speaks, and it can speak of a viewer by the pronouns they set on pronouns.alejo.io. The translations are made with AI help and human review. If a text reads badly, Report... in the ☰ menu → A translation sends in a better wording. Want your own language in there? Share With Others... takes a complete translation file: Adding a translation.


What you need

  • Streamer.bot, connected to your Twitch account. That is the whole dependency.
  • Nothing to pay for, no extra .dll file. Everything lives inside streamer.bot and files beside your Streamer.bot install TwitchSentry creates itself.
  • (Optional) a free VirusTotal API key and/or IPQualityScore one if you want a second opinion. Only for the optional Check Link module.
  • Not sure if TwitchSentry is the right tool for you? Check out this fair Comparison

Credits

Streamer.bot by nate1280 · enNemMesS · Stoshy89 (Tester) · DutchyRay (Dutch Translation) · YOU ♡

Socials

aaskjer on Twitch · TwitchSentry on the Streamer.bot Discord

About

TwitchSentry is a full moderation suit built for streamer.bot and twitch.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors