streamtoolset
DocsChecking session…

Guides

!sr Spotify song requests for Twitch — full setup

Connect your Spotify once, drop a hosted music browser source into OBS, and your chat can queue tracks straight into the Spotify player you're already running. Free, no separate bot, no subscription.

Video walkthrough coming soon

What you're building

A !sr <query> chat command that searches Spotify, picks the best match, and adds the track to your Spotify queue (not a separate jukebox) — so it plays through the same Spotify Connect device you're using for music. Plus an on-stream now-playing widget that shows the album cover, title, artist, and progress bar.

The full command set:

  • !sr <query> — request a song. Accepts a search query, a Spotify URL, or a track ID.
  • !snow — what's playing right now (sends a chat message).
  • !squeue — last few requests still in the queue.
  • !snext / !sprev — skip / previous (mods only by default).
  • !spause / !splay — pause / resume.
  • !svol <0-100> — set Spotify volume.
  • !slike — add the current track to your Liked Songs (mods only).
  • !sadd — append the current track to your stream playlist.

Step 1 — Connect Spotify

Open Connections in the toolset and click Connect Spotify. You'll bounce to Spotify, approve the requested scopes (playback control + read playlists), and bounce back authenticated.

Spotify requires a Premium account for queue control via the API — that's on Spotify's end, not ours. Free Spotify accounts can use the now-playing widget but can't accept queue requests from chat.

Step 2 — Create the music browser source

On the Music tool page, click Create your first source. Copy the URL and add it to OBS as a Browser Source. The recommended size is 460×140 (pinned to a corner) but anything works.

New to OBS browser sources? Read How to add a browser source in OBS first.

Step 3 — Enable commands

On the same Music tool page, scroll to Chat commands and tick Enable commands. Set your Twitch channel name (lowercase login). Permissions default sensibly: !sr is open to everyone with a cooldown; !snext / !spause are mods-only.

Pick a stream playlist

The toolset can append every requested track to a designated "stream playlist" on your Spotify so the queue grows into a long-term shared playlist your regulars can follow. Pick a playlist in the Music tool's settings, or create one called something like "Stream Requests" and select it.

Cooldowns + filtering

Set a global !sr cooldown (default 30s) and a per-user cooldown (default 0). Both apply when set — the slower of the two wins.

You can also exclude specific tracks (right-click → block on the dashboard) so the meme songs your chat keeps queueing don't bury legitimate requests.

Common questions

Do I need a separate bot account?

No. The toolset connects to Twitch IRC anonymously to read chat — you stay logged into your own Twitch account and Spotify takes commands through your auth grant.

Will my music keep playing if I close the toolset tab?

Yes. The chat listener runs in the OBS browser source itself (the music overlay tab). Closing the dashboard tab doesn't affect anything — only the OBS browser source needs to be open.

Can I use this with Streamlabs / StreamElements at the same time?

Yes, but they'll fight over the !sr prefix if you've enabled their version too. Either disable theirs, or change ours to !srq on the Music tool page.

Next

Pair this with Chat Box so viewers see the song-request confirmation right on stream, and Event list so subs / cheers triggered by song requests surface on the overlay.