Variables · supported
{viewer.random:current}
Random eligible current-session viewer; use current, all, or a platform name
variable.global.viewer.random · 2.8.0
Requirements and availability
Uses Twitch live chatters and viewers observed this session on YouTube, Kick, and TikTok. Excludes SheevChat, broadcasters, Bot-tagged accounts, and opted-out viewers.
Picker contexts: automation, timer, command, pad.
Variable providers: twitch, youtube, kick, tiktok.
Behavior
Argument current (default), all or platform. Excludes broadcasters, bots, SheevChat and opted-out viewers; absence returns empty.
Contract details
- Key
- viewer.random
- Syntax
- {viewer.random:current}
- Category
- User
- Description
- Random eligible current-session viewer; use current, all, or a platform name
- Fallback
- Availability
- runtime
- Availability Note
- Uses Twitch live chatters and viewers observed this session on YouTube, Kick, and TikTok. Excludes SheevChat, broadcasters, Bot-tagged accounts, and opted-out viewers.
- Canonical Key
- viewer.random
- Aliases
[]- Producer
- Global command variable engine, resolved on demand.
- Fallback Note
- This fallback applies on null/error/timeout; a resolver may return its own 0, empty string or descriptive value instead.
- Lifetime
- Resolved for this template; data may be live, cached or persisted according to its provider.
Examples
A single variable expression; context and data prerequisites still apply.
{viewer.random:current}Related entries
Source and verification
Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.
- server.js — COMMAND_VARIABLE_DEFINITIONS.viewer.random
- src/features/command-variables.js — createCommandVariableEngine
Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1