Stream Kit DocsTwitch
Connect Twitch chat and EventSub — triggers and channel actions.
Twitch
The Twitch plugin connects your Twitch account for chat, whispers, channel point redemptions, EventSub events, and moderation actions.
Setup
- Create a Twitch application at Twitch Developer Console (or use an existing one).
- Add these OAuth Redirect URLs on the application (exact match required):
http://localhost:9001— main Twitch accounthttp://localhost:9003— bot account (optional, for Bot plugin)
- Copy the Client ID into
plugins/twitch/src/config.ts(seeconfig.example.ts). - Open Plugins → Twitch in Stream Kit.
- Click Connect your Twitch account to start OAuth.
- Authorize Stream Kit in the browser window.
- Confirm status shows Connected.
OAuth runs in the desktop app (Tauri). Stream Kit starts a temporary local server on the redirect port while you authorize. If the browser shows redirect_mismatch or ERR_CONNECTION_REFUSED, verify the redirect URLs above and connect from the running app — not from a bookmarked OAuth URL.
EventSub subscriptions are created automatically for supported events (follows, subs, raids, polls, predictions, etc.).
Requirements
- Twitch account with appropriate channel permissions
- Internet access for OAuth and EventSub
The plugin reports configured when OAuth completes and the connection is healthy.
Features
| Area | Capabilities |
|---|---|
| Chat | Messages, cheers, whispers, hype chat, redemptions |
| Engagement | Follows, subs, gifts, raids, joins/parts |
| Channel | Stream online/offline, channel update, goals, charity, ad breaks, shoutouts received |
| Moderation | Ban, timeout, shield mode, warn, delete message |
| Interactive | Polls, predictions, hype train |
| Actions | Send message, announcement, shoutout, clips, commercials, raids, VIP/mod, get user info |
Twitch chat messages are limited to 500 characters. Stream Kit splits longer outgoing messages (bot Helix API and IRC) into multiple chat lines so they still send instead of failing with HTTP 422.
Triggers and handlers
- Twitch triggers — chat, EventSub, engagement
- Twitch handlers — chat, moderation, polls, predictions
Example trigger IDs
| Trigger | ID |
|---|---|
| Chat message | twitch:twitch:chat:chat-message |
| New follower | twitch:twitch:channel:new-follower |
| Channel point redemption (chat) | twitch:twitch:chat:channel-point-redemption |
| Reward redeemed (EventSub) | twitch:twitch:channel-points:reward-redeemed |
Use the chat redemption trigger for IRC-style redemption messages, and Reward Redeemed for the EventSub channel-points event (richer reward metadata).
Bot integration
Enable the Bot plugin for commands, timers, and moderation on Twitch chat.
The Bot plugin can connect a separate Twitch bot account from Bot → Overview. That account sends messages via the Twitch chat API with the bot identity. Your main Twitch connection on Plugins → Twitch remains responsible for chat listening, EventSub, and moderation.