About StreamTools

StreamTools is a comprehensive Twitch streaming toolkit that puts you in control. Built-in overlays, powerful chat bot, loyalty system, auto-moderation, and live alerts—all managed from one dashboard.

What is StreamTools?

StreamTools is a complete streaming platform designed for Twitch creators who want full control over their stream experience. Unlike third-party services that charge monthly fees or inject branding, StreamTools gives you database-backed overlays, a powerful chat bot, automated moderation, loyalty points, and real-time EventSub integration—all customizable and privacy-respecting.

🎯 Core Features

📺 Overlays & Alerts

• Stream Goals - Followers, subscribers, or donation progress bars with customizable styling and positioning
• Goal Ticker - Horizontal scrolling goal display perfect for top/bottom placement
• Sub-A-Thon Timer - Real-time countdown with automatic time additions from subs/bits/donations
• Shoutout Clips - Automatic clip playback when you shoutout other streamers (!so command) with full clip-cache preloading for smoother and more reliable playback
• Clip Player - Loop your recent clips during BRB/Starting Soon scenes
• Chat Overlay - Two modes: vertical scrolling or horizontal ticker with badges, emotes, and animations
• Animated Socials - Rotating social media icons (Twitch, Discord, YouTube, TikTok, Instagram, X/Twitter, etc.)
• Credits Roll - Hollywood-style scrolling credits for followers, subs, bits, donations, raids with 25 fonts and 35+ customization options
• Active Giveaway/Poll - Show current giveaway or poll progress on stream
• Recent Follower - Display your latest follower with customizable styling
• Ad Break Countdown - Real-time countdown timer during Twitch ad breaks via EventSub

🤖 Chat Bot Features

• Custom Commands - Create unlimited chat commands with variable support ({user}, {args}, {count})
• Song Requests with Priority Queue - YouTube music player with queue management and !sr command. Priority system: Subscribers → Front of line, VIPs → Second, Regular viewers → Third, Your playlist songs → Bottom. Instant BroadcastChannel synchronization across windows
• Now Playing Overlay - OBS browser source showing currently playing song with real-time updates
• Auto-Mod Protection - Comprehensive moderation: caps filter, link blocker with !permit system, emote spam, paragraph limits, symbol spam, repetition detection, Zalgo text blocking, keyword/regex filters, strike system
• Shoutouts - !so command triggers chat message and clip overlay
• Auto-Shoutout - Automatically shoutout whitelisted users on their first message with per-user templates, clip date-range controls, and whitelist chat commands: !addaso/!addso, !editaso, !delaso, !listaso
• Auto-Shoutout Testing - !resetaso (alias !testaso) clears the daily lock for immediate retesting
• Permissions & Safety - Auto-shoutout management commands are restricted to broadcaster, mods, and admins
• Global Bot Counter - !botcount returns the cumulative spam-bot ban total from the public bot count API
• Welcome Settings - Automatically send welcome messages to new chatters on their first message in chat
• Polls & Giveaways - Chat-based voting (!vote) and automatic entry detection for keywords
• Timers - Automated periodic chat messages (socials, rules, reminders)
• Stream Timer - Countdown / countup timer overlay with customizable styling for scheduled events or time tracking
• Clip Creation - !clip command creates clips while live
• Mod Commands - !title, !game for channel management (Twitch API integration)
• Bot Features Toggle - Granular enable/disable for all feature categories without turning bot off

🚫 Anti-Spam & Auto-Ban System

StreamTools includes a powerful real-time anti-spam detection system with two flexible ban modes for protecting your channel from viewerbots and spam accounts. Choose between fully automatic or manual control — both provide cross-channel protection across all your StreamTools-enabled channels. Let your MODS focus on the real viewers & StreamTools handle the rest! Our Spam Detection & Auto-Ban System will do the work. No more tabbing out to ban a spambot!!

Two Ban Modes Available:

• Auto-Ban Mode - Fully automatic bot detection and banning. The system continuously monitors chat, detects spam-like behavior, and automatically bans threats across all channels that have Auto-Ban enabled. Set it and forget it — bots are handled instantly without your intervention.
• !syncbots Mode - Manual control for broadcasters who prefer to review detections first. Use the !syncbots command (MOD/BROADCASTER only) to manually sync verified spam bots across all your channels with this mode enabled. Gives you full transparency and control over every ban action.

Spam Detection Tiers:

• TIER 1: Known Spam Domains - Automatically detects and bans users posting messages containing any of 1,135+ known spam domains. Banned instantly across all channels with Auto-Ban enabled.
• TIER 2: Suspicious Patterns - Intelligently detects messages with spam-like patterns (e.g., "buy instant viewers", "cheap followers") and flags them for review with confidence scoring. View detailed detection logs to confirm bans or mark as legitimate.

Advanced Protection Features:

• Cross-Channel Sync - Bots detected in one channel are automatically synced and banned across ALL channels in your StreamTools account that have bot protection enabled. Prevents spam networks from hopping between your streams.
• !addbot Command - Manually add suspected bots to your local channel's ban list. Works with both Auto-Ban and !syncbots modes. Mods and broadcasters only.
• Three-Source Bot Consolidation - Automatically merges bots from: (1) auto-detected spam accounts, (2) manually added via !addbot command, (3) production bot lists. Eliminates duplicates and maintains global consistency.
• Multi-Channel !syncbots Command - MOD/BROADCASTER command to instantly apply verified spam bots across all channels. Displays sync summary: total bots found, newly banned, already banned, skipped. All actions timestamped and logged.
• Protected Users - Mods, broadcasters, VIPs, and subscribers are automatically exempt from spam filtering to prevent false positives on legitimate users.
• Token Refresh System - Automatic Twitch token refresh every 12 hours via cron ensures continuous ban enforcement without 401 errors that could silently disable bans.
• 24/7 Monitoring - System runs continuously while your bot is connected, catching spam even when you're AFK or sleeping. EventSub integration detects restricted/banned users automatically.

🛡️ Let's Fight Against Bots Together!

With the support of streamers using StreamTools, we're building a community-powered defense against spam networks. Every detection strengthens the system for everyone. Current status: 1,644 Bots Banned & climbing fast. This is an ongoing battle against scammers and spammers — join the fight and help keep Twitch cleaner!

💎 Loyalty Points System

• Automatic Points - Viewers earn points per minute with subscriber bonus multipliers
• Card Games - !poker (Texas Hold'em vs dealer, 2x payout), !blackjack (classic 21, 2.5x for natural), !higherlower (guess next card, 2x)
• Casino Games - !gamble (50/50 double-or-nothing), !slots (jackpot multipliers), !roulette (color/number betting)
• Interactive Games - !wordscramble (first correct answer wins), !lottery (buy tickets, streamer draws winner)
• Social Commands - !hydrate (water reminder), !heist (group betting), !duel (1v1 challenges), !timeout (fun punishment)
• Tier System - Bronze → Diamond progression based on total points earned
• Leaderboard Overlay - Display top viewers with their point counts and tier badges using OBS browser source
• Leaderboards - !leaderboard shows top 3 and your rank
• EventSub Integration - Bonus points for follows, subs, bits, raids tracked automatically

� StreamBoss - Interactive Boss Fight Game

• Dynamic Boss Battles - Viewers work together to defeat a continuously evolving boss. Boss grows through 10 levels with scaling difficulty.
• END BOSS Phase - Special final boss form at level 10. When defeated, victory announcements are sent from bot account (not broadcaster), rewarding viewers with exclusive recognition.
• Dynamic Boss Naming - When defeated, the boss name becomes "The Stream Boss - [Attacker Name]" until reset with !boss reset command, celebrating the defeating attacker.
• Event-Based Damage - Viewers deal damage via Subscriptions, Bits, Tips, and Raids with customizable damage weights. Different event types deal different damage.
• Level & Phase Tracking - Boss levels 1-9 are standard form, level 10 activates END BOSS with enhanced HP and damage multipliers.
• Status Display - !boss status shows current health, level, phase, and top 3 attackers
• Customizable Settings - Configure base HP, level multiplier, damage weights for each event type, end boss trigger, and overlay styling.

☠️ Death Counter - Track Deaths with Funny Roasts

• !dead Command - Increment death count with random funny roasts about dying. Each viewer gets their own shuffled roast queue that cycles through unique messages.
• Persistent State - Death count is database-backed and persists across bot restarts
• Mod Controls - !dead reset, !dead set [n], !dead +N, !dead -N for precise management with automatic funny messages
• Custom Command Alias - Rename !dead to !frag, !rip, !fallen, or any custom trigger your chat prefers
• Death Counter Overlay - OBS browser source displaying live death count with smooth animations, customizable colors, fonts, and styling
• 50+ Funny Sayings - Unique roasts for each death like "Death #5 - Respawn screen looking smooth today" or "They fought bravely… for about 3 seconds"

⚔️ Kill Counter - Celebrate Your Victories

• !kill Command - Increment kill count with random funny celebration messages. Just like death counter, each viewer gets their own shuffled roast queue.
• Persistent State - Kill count is database-backed and persists across bot restarts
• Mod Controls - !kill reset, !kill set [n], !kill +N, !kill -N for precise management with celebration messages
• Custom Command Alias - Rename !kill to !frag, !elimination, !headshot, or any custom trigger
• Kill Counter Overlay - OBS browser source displaying live kill count with smooth animations, green accent color, customizable styling
• 50+ Celebration Sayings - Unique roasts for each kill like "Another one bites the respawn screen" or "That kill came with free air miles"
• Unified Settings Page - Death and kill counters on the same page with tabbed interface for easy setup and management

�🔔 Live Integration

• EventSub Webhooks - Real-time detection of follows, subs, bits, raids, ad breaks via Twitch API
• Event Messages - Custom messages triggered by specific events (follows, subs, bits, raids, etc.) with variable support and per-event configuration
• Discord Alerts - Monitor multiple streamers and send Discord notifications when they go live, with configurable channels and role mentions
• Stream Clips - Browse and create clips directly from dashboard
• Live Status Tracking - Automatic detection when you go live/offline for timers and features

⚙️ Management & Tools

• Team Access - Grant editors access to specific features (Song Requests, Polls, Giveaways, etc.) with username + PIN login
• RaidOut - Plan your end-of-stream raids with candidate browsing
• Events Log - Track all bot actions, giveaways, polls, shoutouts
• Contributors - Showcase top supporters and donors
• Privacy Mode - Blur sensitive tokens for safe screenshots
• Dark Mode - Full dark theme support with per-browser persistence
• OBS Export - One-click export of all overlays as OBS Scene Collection

Creator & Credits

This site was created and maintained by RagingStray. If you appreciate the project and want to support ongoing development and hosting costs, please consider donating — your contributions help keep the service online and improved.

Donations

Donations are used directly to keep the project running and improving. Typical uses for donations include:

• Paying for web-hosting (monthly server fees)
• Upgrading server speed and CPU to reduce latency for live features
• Increasing storage for clips and recordings
• Covering domain and SSL certificate costs
• Purchasing development tooling and third-party services (when required)

You can donate using the Donate button in the sidebar (top-right of the sidebar area). Any contribution — large or small — helps keep the project healthy and lets us prioritize reliability improvements and new features.

Security & Privacy

StreamTools takes your security seriously:

• AES-256-CBC Encryption - All OAuth tokens are encrypted in the database using industry-standard AES-256-CBC encryption with unique initialization vectors
• Secure Token Storage - Access and refresh tokens never stored as plaintext, automatically encrypted on login and refresh across all platforms
• Privacy Mode - Blur sensitive fields in the UI for safe screenshots or streams
• Minimal Data Collection - Only essential data needed for overlays and features is stored
• Overlay Token Protection - Regenerate your overlay token anytime from Settings if compromised

How StreamTools Works

StreamTools uses browser-based overlays that connect to your StreamTools account via secure tokens. When you add an overlay URL as a Browser Source in OBS, it automatically pulls your current settings and displays accordingly. Changes made in the dashboard update overlays in real-time without editing OBS sources.

Three-Layer Architecture:

• Dashboard (Web) - Manage settings, create giveaways/polls, view stats
• Bot (Node.js) - Connects to Twitch IRC, processes commands, handles EventSub webhooks
• Overlays (Browser Sources) - Live displays in OBS that poll for updates or use realtime sockets

Getting Started

1. Login with Twitch - Authenticate with your Twitch account on the login page
2. Add Overlays to OBS - Access the Overlays in there pages or in the Export to OBS feature! (1920×1080 recommended)
3. Customize Your Stream - Adjust colors, fonts, positions in the settings pages
4. Configure Bot Features - Set up custom commands, timers, loyalty points, and auto-moderation
5. Go Live - Enable features and start streaming with your new toolkit

See the Help / User Guide for detailed setup instructions and troubleshooting.

Contribute & Report Issues

Contributions are welcome. If you'd like to report a bug, request a feature, please send me a message on discord. If you need help integrating overlays into OBS or troubleshooting, the Help / Guide page contains common setup steps and troubleshooting tips.

---

Thanks for using StreamTools. Your support keeps projects like this possible.