♪

Now playing

Nothing playing

Start something in Spotify. Requests play after the current song.

0:00

Your music

Requests are closed. Songs already in the queue still play.

Requests won't play on their own: the Spotify SR Tick timer isn't running. In Streamer.bot, open Settings → Timed Actions and turn it on (and check the action Spotify SR - Tick is enabled).

YouTube requests are waiting, but the YouTube player isn't open in OBS. Add it under Setup → YouTube; they start once it's open.

Queue

Requests open

#SongRequested byTimePaid

The queue is empty Viewers request songs with !sr song name, a Spotify link or a YouTube link.

Rules

Who can request, what it costs, and the limits.

Price

Charge viewers from your points system. Channel point rewards use their own cost instead.

Cost per request0 makes requests free

Currency user variableThe persisted Twitch user variable holding balances

Currency name in chat

Free usersComma-separated Twitch names

Who can request

Give subscribers and VIPs their own price and limit, or keep requests to them. Mods and you can always request.

Requests are for

Price for subscribersEmpty: the same as everyone

Price for VIPsEmpty: the same as everyone

Songs waiting, subs and VIPsEmpty: the same as everyone

Limits

Keep the queue varied. The broadcaster ignores these limits.

Cooldown per viewerSeconds between requests

Max song lengthMinutes, 0 for no limit

Max songs per viewerWaiting in the queue at once

Moderation

Bans, repeats and vote skipping.

Bans

A request that hits a ban is turned down and nobody pays.

Block explicit songsUses Spotify's explicit tag

Banned artistsOne per line, or comma separated

Banned songsMods: !srban bans what's playing; the ban button on the queue bans a request

Fair play

Keep the same songs from coming back, and let chat skip what it doesn't like.

No repeats forMinutes before a request that played can be asked for again. 0: off

Votes to skip!voteskip votes that skip a song. 0: off. A song's requester skips it with one vote

Refund early skipsA request you or a mod skip before it played this much of itself is refunded. 0: never. !voteskip and !srban don't refund

%

Chat

Everything the bot says, in your words.

How the bot talks

How replies reach a viewer, and whether a request starting is announced.

Messages to a viewerRequests, refusals, refunds

Announce in chat“Now playing … (requested by …)”

Messages

Everything the bot says in chat. Change the wording or switch a message off. Words in {braces} are filled in for you.

Setup

Connect Spotify and set up the YouTube player, the OBS dock and the playlist.

1Spotify connection

Requests play through your own Spotify account. You need Spotify Premium and a free developer app.

Open the Spotify developer dashboard. Reuse your app if you have one, or create one and tick Web API.
Under Redirect URIs, add the address below, click Add, then Save.
Paste the app's Client ID here and press Connect Spotify.

Redirect URI

Client ID

Not connected

2Playback device

Where requested songs play. Open Spotify and play something so your device shows up.

Play requests on

4Request playlist

Every Spotify request that plays is added to a private playlist in your Spotify, so you can find those songs again.

Keep a playlist

Playlist nameUsed when it's made

Status

5OBS dock

Put this panel inside OBS so you can manage requests without leaving it. It talks to Streamer.bot through its WebSocket server.

In Streamer.bot, open Servers/Clients → WebSocket Server. Tick Auto Start and press Start Server.
Check the port below matches it. If you set a password there, enter it too.
In OBS, open Docks → Custom Browser Docks. Name it Song Requests, paste the URL and click Apply. The dock is hosted on byttenapple.com and updates by itself; it only ever talks to the Streamer.bot on your own PC.

WebSocket portStreamer.bot's default is 8080

WebSocket passwordOnly if authentication is on

Dock URL

The password is saved in the URL, so only paste it into your own OBS.