!sr

Requirements and availability

Enabled command, connected eligible platform, configured authority and cooldown; individual handler requirements also apply.

Picker contexts: command.

Behavior

Request a song.

Limitations

• Defaults describe a fresh configuration; existing settings and migration normalization may differ. Platform toggles do not guarantee that a provider API supports the command.
• Command triggers/aliases may be customized; use the effective configured trigger.

Contract details

Usage

!sr <URL|search text>

Defaults

{
  "enabled": true,
  "aliases": [
    "songrequest"
  ],
  "requiredAuthority": "anyone",
  "cooldownSec": 30,
  "globalCooldownSec": 0,
  "platforms": {
    "twitch": true,
    "youtube": true,
    "kick": true
  },
  "responseTemplate": "@{user} — \"{title}\" by {artist} added to the queue!"
}

Aliases

[
  "songrequest"
]

Response Variables

[
  "user",
  "title",
  "artist"
]

Examples

Usage notation: <required>, [optional]; replace placeholders before sending.

!sr <URL|search text>

Related entries

• {user} in !sr
• {title} in !sr
• {artist} in !sr

Source and verification

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

• server.js — DEFAULT_COMMANDS.sr
• src/features/media/mediaCommands.js — handleSongRequestCommand

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1