Shoutout
Puts another streamer in the spotlight. Type your shoutout command — !so pixelpanda —
and the overlay shows their profile picture, your message and one of their Twitch clips.
It can also do it on its own when someone raids you, or when a streamer from your
Streamer.Bot user group writes in your chat.
Platforms: Twitch (switched off: the page says so and no browser source runs the widget)
Action pack: needed — Stream UI - Backend fetches the streamer's picture, last game and clips, checks the user group and sends Twitch's shoutout. See Who needs what.
How it works
- Three ways to start one: your command, a raid (Shout out raiders), or the first message of a member of a Streamer.Bot user group (Group members at their first message).
- One shoutout at a time. Others wait in a queue and play one after the other. A channel already on screen or in the queue is not added twice.
- A clip from their channel. The widget picks a random clip from the last year (from all time if the channel has none), and plays it with its title and who clipped it. When it ends, the shoutout leaves.
- No clip, no problem. When the channel has no clip, or its video can't play, the shoutout shows the picture and header alone, for Time on screen without a clip.
- Chat and Twitch's shoutout are sent by the overlay that runs the actions only, never by the preview on the website, so testing never posts in your chat. When the shoutout is shown in another overlay, that overlay plays the clip and the one that runs the actions sends the messages without showing anything. → Which overlay runs the actions
- Show it in one overlay. Each overlay showing it plays the clip, sound included — the Layout tab warns you.
!so by default) and the
permissions you want — moderators only, for example. Stream UI only listens to it, and
reads the channel from the first word after it: !so pixelpanda or !so @pixelpanda.The page
The widget's page works like a small app:
- Settings, Style and Controls, the tabs over the editor, switch what it shows.
- The Settings tab has one section, Shoutout settings, so its fields fill the main area with no column on the left, in five parts: Player header, Player footer, Sound, Chat message and Triggers (Commands, Raids and First message). The Style and Controls tabs list theirs in a column on the left: click one to edit it in the main area.
- Widget preview, the panel against the window's right edge: the preview, the test buttons and the widget's own URL. The arrow at the top folds it to a slim rail. Drag its left edge to widen it, up to half the window; it keeps its width. Widget shows the widget in its position, cut from the canvas as your browser source draws it; On canvas, the whole canvas.
How to set it up
Create the command in Streamer.Bot
Commands tab → add !so (or your own), with its permissions. It needs no action.
Switch the widget on
On the Widgets page, check that Shoutout is on. It is under the Twitch clips tab, and on by default.
Pick what starts a shoutout
Under Triggers, check the Command matches yours, then switch Shout out raiders and Group members at their first message on or off. For group members, type the Streamer.Bot user group to watch (Streamer.Bot → Users → Groups).
Choose what is sent
Under Chat message, switch on Send a chat message to post a message in your chat,
and Send a Twitch shoutout for Twitch's own /shoutout.
Update your browser source
Copy the overlay URL again into your browser source → Layout and browser source.
Settings
Player header
| Setting | Default | Detail |
|---|---|---|
| Show header | on | The header line: the streamer's picture and the header. Off hides both. |
| Header | Go check twitch.tv/{login} | The line next to the streamer's picture. Only when Show header is on. |
| Show streamer profile picture | on | The streamer's picture beside the header. Only when Show header is on. |
| Show header only if no clip found | off | The header shows only for a shoutout without a clip (another channel's, or a clip that can't play). |
| Time on screen without a clip | 10 s | How long a shoutout without a clip stays, from 3 to 60 s. Only when Show header only if no clip found is on. |
Player footer
| Setting | Default | Detail |
|---|---|---|
| Show clip title | on | The clip's title, under the video. |
| Show clipper credit | on | Who made the clip, after its title. |
| Clipper text | Clipped by {clipper} | That credit. {clipper} is who made the clip. Only when Show clipper credit is on. |
Sound
| Setting | Default | Detail |
|---|---|---|
| Volume | 100 % | The clip's sound, from 0 to 100 %. Previews always play muted. |
Chat message
| Setting | Default | Detail |
|---|---|---|
| Send a chat message | off | Posts a message in your Twitch chat with each shoutout. |
| Send as bot | on | Posts it with your bot account, if one is connected in Streamer.Bot. Only when Send a chat message is on. |
| Chat message | Go check out {user} at twitch.tv/{login}! Last seen playing {game}. | That message. Only when Send a chat message is on. |
| Send a Twitch shoutout | off | Also sends Twitch's own /shoutout for the channel. Twitch's limits apply: you must be live, with a wait between two shoutouts. |
Triggers
| Setting | Default | Detail |
|---|---|---|
| Commands › Command | !so | Your Streamer.Bot command's text. The reminder under it: create this command in Streamer.Bot (Commands tab), with the permissions you want. |
| Raids › Shout out raiders | on | Shouts out whoever raids you. |
| First message › Group members at their first message | off | Shouts out a member of a Streamer.Bot user group the first time they write, once per browser source load. Ignored users are skipped. |
| First message › Streamer.bot group | Twitch Streamers | The group to watch. Only when Group members at their first message is on. |
Header and Chat message can use these variables (listed under each field on the page):
| Variable | Example | Detail |
|---|---|---|
{user} | PixelPanda | The streamer's display name. |
{login} | pixelpanda | Their login, as in twitch.tv/{login}. |
{game} | Hollow Knight | What they last streamed. |
Style
Shoutout and Clip Autoplayer share one clip player, so they look alike until you change a field of one of them. On the Style tab, the Styles column lists the elements: pick one to style it in the main area, highlighted on the preview; Text opens a column of its three texts. See Appearance.
| Element | Detail |
|---|---|
| Container | The widget's box, clear by default: it lines up the player on the widget's position. |
| Background | The player: its Width is the player's size, 800 px by default; the video fills it, 16:9 while the Video's Height is Auto. Follows the overlay's Widgets background style: the card around the video and its texts. |
| Video | The clip's frame: black, rounded, with a shadow. |
| Picture | The streamer's profile picture. Listed while Show streamer profile picture is on. |
| Text › Header | Your message. Follows the overlay's Titles style. |
| Text › Clip title | The clip's title, under the video. Follows the overlay's Titles style. |
| Text › Clipper | After the title, past a hyphen. Follows the overlay's Text style. |
| Show / hide transition | How the shoutout appears and leaves. |
Default position
Position Center, automatic width, size 100 %. The player's size is the Background width on the Style tab; the position is changed on the Overlay builder's Layout tab.
Streamer.Bot events it listens to
| Event | What it triggers |
|---|---|
Command.Triggered | Your command — shouts out the channel typed after it |
Twitch.Raid | A raid — shouts out the raider. Only with Shout out raiders on |
Twitch.FirstWord | A first message — shouts out group members. Only with Group members at their first message on |
| The Pause, Resume, Skip shoutout and Clear queue triggers you picked | Pauses or resumes the widget, skips the shoutout, or clears the queue |
Misc.GlobalVariableUpdated, Misc.GlobalVariableCreated | The widget paused or resumed elsewhere (the page, the controls window, your actions) |
General.Custom | The Backend action's answers (clips, picture, group check) and the buttons |
Controls
On the widget page's Controls tab:
- Controls, the column on the left, lists Pause, Resume, Skip shoutout and Clear queue, each with the names of its triggers. Pick one to see its triggers in Trigger list, beside it.
- Trigger list: the Streamer.Bot triggers that do it. Add trigger adds one,
conditions included → Triggers and conditions.
- Pause — default: Twitch Stream Offline.
- Resume — default: Twitch Stream Online.
- Skip shoutout, Clear queue — none by default.
- The main area shows Shoutout: Running or Paused, with the buttons Resume and Pause, then the other buttons, all also in the controls window:
| Control | What it does |
|---|---|
| Pause | The shoutout on screen leaves, the queue is emptied, and no shoutout starts until you resume → Pause and resume. |
| Resume | Shoutouts start again. |
| Skip shoutout | The shoutout on screen leaves; the next in the queue follows. |
| Clear queue | Drops the shoutouts waiting, and the one on screen leaves. |
The buttons need Streamer.Bot connected.
Pause and resume
While paused, nobody is shouted out: no clip, no chat message, no Twitch shoutout. Your command, raids and group members writing meanwhile are ignored, not queued, so resuming never plays a backlog. Group members who write while it is paused count as shouted out until the browser source reloads.
The state is kept in Streamer.Bot, in the persisted global streamUi.off.shoutout (1:
paused; 0 or none: running), so it lasts until you resume, even if the browser source
reloads, and every overlay follows it at once. Your own actions can pause or resume the
widget too, with a Global (Set) sub-action on that variable. The buttons and triggers
need Stream UI - Backend.

