Song Requests
Song requests let viewers or integrations add YouTube videos to a Kicklet queue. Use them for music queues, community video queues, or commands that let viewers request a song.
Open Song Requests in the Kicklet dashboard to manage the queue, playback, and the !sr default command.
Queue behavior
Kicklet stores song requests per account. Each request includes a title, video ID, duration, and requester.
The queue has a maximum of 50 requests. Livestream videos are rejected. If a maximum duration is configured for the request, videos longer than that limit are rejected.
Add requests
A request can be added from a YouTube URL, video ID, or search term. Kicklet resolves the video information before adding it to the queue.
Use the add form to add a song yourself. Viewers can add songs through the default !sr command when that command is active. The status button in the Song Requests header turns the !sr default command on or off.
Kicklet code can add requests with the Song Requests helpers. External integrations can use the HTTP API, but check the Public API page first because those endpoints are transitional.
Dashboard overview
Use the top metrics to check whether requests are flowing: the queue count excludes the current song, total duration includes the whole list, and the chat command status shows whether viewers can request songs with !sr.
Add a song from the form, then manage the queue below it. The current song stays at the top; drag queued songs underneath it to reorder them, or use the row actions to delete a request or move it to the top.
Manage playback
From the dashboard, code helpers, or API, you can:
| Action | Description |
|---|---|
| List queue | Show all queued requests. |
| Current song | Read the first item in the queue. |
| Skip | Remove the current song. |
| Delete | Remove one request by ID. |
| Clear | Remove every request in the queue. |
| Move | Move a request up or down. |
| Move to top | Put a request at the top of the queue. |
| Volume | Send a volume update to the song player. |
| Pause | Pause or resume the song player. |
The queue supports drag-and-drop reordering. The currently playing song stays at the top while queued songs can be reordered below it.
Queue and player changes are sent to the song request player in real time.
Player and widget control
When widget control is off, the dashboard browser plays the current song with the embedded YouTube player. When widget control is on, playback is handled by the song request widget instead, and the dashboard sends remote playback updates such as pause and volume changes.
Public queue
Kicklet exposes a public read endpoint for the song queue. Use it for overlays or public pages that should display the current queue without an API token.