Skip to content

Song requests

Viewers wish for songs in chat or on the website, and you and your moderators work through the song queue. This page explains how to set up your song lists, how viewers request songs, and how to run the queue during a stream.

  • Song lists are your repertoire. Viewers browse them on the website and request songs from them.
  • The song queue holds the requests: the song being played right now (the current song) on top, then the waiting requests in order.
  • Two kinds of request: a song list request matches exactly one song of your lists and shows as “Artist - Title”. A free text request is any other text, kept as the viewer typed it.
  • Three states: song requests are Open (everyone may request), Closed (only moderators may request) or Off (the song request commands give no response at all).

New channels start with song requests Off. When you’re ready, open them as described under Open and close requests.

Song lists are managed by the managers: you and your Twitch channel editors. Moderators can’t change the song lists.

  1. Open your song list at boingbot.com/<your-channel>/songlist (in the dashboard: Song requests > Song list).
  2. Turn on the Manage switch at the top right. The table now shows the management columns and the buttons Lists, Categories and Add song.
  3. Turn Manage off again when you’re done, to see the page as your viewers do.

You can have several lists, for example “Covers” and “Originals”. Click Lists to see them with their number of songs.

  • Add list creates a list; Edit renames or deletes it. Every list needs its own name.
  • The switch in the Enabled column takes effect at once. Disabled lists are hidden from viewers, and their songs can’t be found or requested.
  • With more than one list, each list is a tab. Drag the tabs to change the order of the lists.
  • Only an empty list can be deleted. Move or delete its songs first.

Every song belongs to a category, for example “Rock” or “Piano”. Every channel has at least one; a new channel starts with “Songs”. Click Categories to manage them.

  • Add category asks for a name and, if your channel is affiliated or partnered, one of your channel emotes. The emote appears in front of song list requests in the song queue.
  • Deleting a category that has songs asks which category the songs move to. The last category can’t be deleted.

Click Add song and fill in:

Field Notes
Title, Artist / Composer / Source Required
List, Category The category starts with the one you used last
Link Optional, for example to a recording; must start with http:// or https://
Search terms Extra words the search finds this song by: other spellings, typos, a translated title. Viewers don’t see them.
Enabled Disabled songs stay visible but can’t be requested
Lyrics Edit lyrics opens a text field for the lyrics, with or without chords

If a song with the same title and artist already exists, the dialog names it and its list. You can still save.

Each row has Edit and a ⋯ menu with Disable / Enable, Lyrics, Change category, Move to list and Delete. To change several songs at once, tick their checkboxes and use the bar above the table.

You and your editors can open a song’s lyrics from the ⋯ menu (Lyrics) or with the 📃 button next to a request in the song queue. The lyrics open in a new window, with chords in bold. Autoscroll scrolls the page; - and + change the speed.

Viewers find your song list at boingbot.com/<your-channel>/songlist, or through the !songlist command. They can:

  • switch between your lists with the tabs,
  • type into Search the song list,
  • filter by category, Only requestable (hides disabled songs and songs already in the queue) or New songs (added in the last 28 days),
  • sort by clicking a column header,
  • see when a song was last played, or “in queue at position #3” and “currently being played”,
  • click Info for a song’s request statistics.

The Request button tells them why a song can’t be requested right now: In queue, Playing or, after a song was played recently, Cooldown 12 min.

Who may see the song list and the song queue is set in Channel > Settings under Page access levels > Song requests.

Viewers request with !sr and a few words of the song:

!sr wonderwall
@lena_loops Your request "Oasis - Wonderwall" was added to the queue and is now at position #2.

boing_bot searches your enabled lists. Every word must appear in the title, the artist or the search terms of a song.

  • One match becomes a song list request.
  • Several matches get “Your song list query matched 3 entries. Please refine your search or use “!sr random <input>” if you don’t care.” With random in front of the words, boing_bot picks one of the matching songs that isn’t in the queue yet.
  • “Title by artist”: if nothing matches the whole text, boing_bot also tries it as a title and an artist, for example !sr yesterday by beatles.
  • No match becomes a free text request if free text requests are on; otherwise the viewer is pointed to the song list.

A request is refused, with an explanation in chat, when it’s already in the queue or playing, when the viewer has reached the limit of open requests, when the song was played too recently, or when the viewer’s level isn’t allowed to request. While requests are closed, viewers get “Song requests are closed at the moment.”

Moderators can request for someone else with !sr @name <song>. Moderators and the broadcaster have no request limit and no song cooldown.

All commands are available to everyone by default. The default cooldown is 20 seconds per user and 10 seconds for the whole chat, except where the table says otherwise. You and your moderators can rename the commands, add aliases and change cooldowns in the dashboard under Chat > Commands.

Command Aliases What it does
!songrequest <song> !sr Adds a request. 20 seconds per user, no chat-wide cooldown.
!replacesong <song> Replaces the viewer’s newest waiting request, keeping its place in the queue. Moderators can use !replacesong @name <song>. 20 seconds per user.
!wrongsong Removes the viewer’s newest waiting request.
!mysong !when Shows the position of the viewer’s next request. Moderators can add a name.
!currentsong !cs, !song Shows the current song and who requested it.
!lastsong !last Shows the last played song.
!songqueue !sq, !queue Links to the song queue page.
!songlist !sl Links to the song list page.
!hassong <words> Checks whether your song list has matching songs.
!lastplayed <words> !lp Shows when a song was last played.
!favorite !favourite Shows a viewer’s most requested song (!favorite @name), or a song’s top requesters (!favorite <words>).
!request !howtosr Explains how to request songs in your channel.
!songrequests !srs Shows whether requests are open. Moderators open and close them with it. 5 seconds per user and chat-wide.

While song requests are Off, none of these commands answers.

Signed-in viewers can click Request next to a song on the song list. The same rules as in chat apply: the request limit, the song cooldown, the state of song requests and the level required for song list requests. A viewer who isn’t signed in sees “Must be logged in to request a song!”.

In the song queue, viewers can take back their own waiting requests with Remove.

Moderators can request even while requests are closed and can request disabled songs. Their Request button opens the dialog Request a song: enter the name of the viewer the request is for (or leave it blank for yourself) and tick Add as prio request to place it after the other priority requests at the top of the queue. Moderators also get a Play now button that makes a song the current song directly.

The song queue at boingbot.com/<your-channel>/songqueue updates live for everyone. It shows the current song (▶) and then the waiting requests with the requester, the time of the request, when the song was last played and whether it has priority.

You and your moderators (including lead moderators) also get these controls:

Control What it does
Accept Makes a waiting request the current song. Shown while there is no current song.
Reject Removes a waiting request without playing it.
Mark played Marks the current song as played.
Reset Puts the current song back to its former place in the queue.
Prio (Yes / No) Gives a request priority or takes it away. This doesn’t move the request.
≡ (drag) Drag a request to change its place in the queue.
Pencil Adds a comment to a request. Only moderators see comments.
Set current song Sets the song being played. From three characters on, it suggests songs from your lists; any other text becomes a free text request.
Bulk add Adds several requests at once, one per line, without any checks. Lines that match exactly one song of your lists become song list requests; a line whose song is already in the queue is skipped.
Clear queue Marks the current song as played and rejects all waiting requests, after a confirmation.

Moderators also see each requester’s role badge and whether they are in chat right now.

When you set a current song while another one is playing, boing_bot asks “Did <your-channel> finish playing it?”: Yes marks the old one as played, No (keep it queued) puts it back into the queue.

Song requests are Open, Closed or Off. While closed, only moderators and the broadcaster can request. You can change the state in three places, and while the bot is on, every opening, closing and change of the slots is announced in chat:

  • In chat, moderators type !srs open (also on, enable), !srs close (also off, disable), or !srs 5 to open with 5 slots. Anyone can type !srs to see the state.
  • On the song queue page, moderators use the Requests open / Requests closed switch.
  • In the song request settings (see below). Off can only be set there.
Song requests are now OPEN. There are 5 song request slots available.
Song requests are now CLOSED.

Slots limit how many songs are requested in one opening. Every request made since the opening counts, as long as it is waiting, current or played; rejected and removed requests don’t. When the last slot is used, requests close by themselves:

Song requests are now CLOSED because the maximum number of requests has been reached.

On the song queue page, the slots button next to the switch opens a small panel while requests are open:

  • Without a limit: enter a New slot limit and click Set limit. Like !srs 5, this starts a new opening, so earlier requests don’t count.
  • With a limit: Add or remove slots (negative numbers remove slots) and Apply, or Remove the limit.

Open Song requests > Settings in the dashboard. You and your moderators can change these settings; save them with Save settings.

Setting Options
State Open, Closed or Off. Changing it here does the same as !srs open or !srs close in chat and is announced there.
Open requests per viewer One limit each for Everyone, Subscribers and VIPs. The highest of these levels a viewer has decides. Empty means no limit. Moderators and the broadcaster have no limit.
Song cooldown (minutes) How long after a song was played it can be requested again. 0 turns it off.
Request types For Song list and Free text: a State (On, Disabled, which refuses requests with a note, or Off, which hides the type completely) and Who can request (Everyone, Subscribers, VIPs, Moderators, Lead moderators, Broadcaster).

New channels start with the state Off, both request types On for everyone, no request limit and no song cooldown.

boing_bot can tell viewers what happens to their requests. Open Notifications in the dashboard (you and your editors) and look for the section Song requests:

Event When
Song request added A request was added on the song list page
Song request accepted A request became the current song
Song request rejected A request was rejected
Song request reset The current song was put back into the queue
Song request played The current song was marked as played

For each event, choose None, Whisper to the requester or Public chat message (“Song request added” offers no whisper). All events start with None, and you can change the texts. Your own requests never trigger a notification, and Clear queue sends none.