youtube twitch #kick obs api chat Extensions > Submissions Extensions
Better Song Request 1.3.1
Description
A dynamic, self-hosted YouTube Music player and Song Request system built specifically for Streamer.bot. This system runs locally in your browser, uses your own Google API key (no third-party server dependencies), and communicates directly with your chat via Streamer.bot’s built-in WebSockets.
If you like the project, support me here:
Every contribution helps me develop the project! Thank you in advance!
Key Features
- No Third-Party Services: Runs entirely locally on Streamer.bot’s HTTP and WebSocket servers. Your data and API keys stay on your machine.
- Multi-stream support: Whether you stream on Twitch, Kick, or YouTube! Works equally independently and simultaneously!
- Drag & Drop Queue: Easily manage viewer requests by dragging and dropping tracks to change their order in real-time.
- Base Playlists (Fallback): Add your favorite YouTube playlists. If the viewer queue is empty, the player will automatically shuffle and play tracks from your base playlists.
- Blacklist / Ban System: Ban troll songs with one click. Banned songs are instantly skipped and removed.
- Multi-language Support: UI and Bot chat responses are available in English, Polish, Ukrainian, German, French, and Turkish.
- Chat Commands: Support for standard SR commands (
!sr [link/title],!voteskip,!skip,!wrongsong,!volume). - Request Limits: Configurable active request limits per user and globally, with chat warnings when limits are reached.
- Favorites: Star tracks from the base list, queue, or current song. Favorites stay at the top of the left panel and are included in START/SHUFFLE.
- Viewer Request History: Saves unique songs added from chat, with search, user/date filters, favorite support, and quick re-add to the queue.
- Custom Message Control: Edit each bot chat response and disable individual messages without deleting their text.
- Auto-Skip: Automatically skips unavailable, blocked, or deleted videos.
- Compact widget for OBS: A standalone floating widget that displays the title and progress of the currently playing song. Perfect for adding to OBS! It uses Web Socket to refresh the status live.
- Diagnostics & Import Check: The page can check the active Streamer.bot import and show exactly what is missing when a required import update is needed.
- Settings Backup: Export and import local page settings, favorites, viewer history, and custom chat message states without including the YouTube API key.
Import File
- Better_Song_Request_1.0.6.sb (14.4 KB)
Resources
Installation
In Streamer.bot click the Import button in the top menu. Drag the .sb file into the Import String field.
Step 1: Download the files
Download the latest index.html, now-playing-widget.html, style.css, app.js and translations.js or Source code (zip) from the Releases tab and save them in a dedicated folder on your PC (e.g., C:\StreamerBot\Better Song Request\).
Step 2: Streamer.bot HTTP Server
The file needs to be hosted locally to bypass browser restrictions and communicate with the API properly.
- Open Streamer.bot and go to Servers/Clients → HTTP Server.
- Set the Port (default
7474). - In the Mappings section, click the folder icon and select the folder where you saved
index.html. - In the PATH field, enter a subfolder name (e.g.,
betterSongRequest). - Check Auto Start and click Start Server. Your player is now accessible at
http://localhost:7474/betterSongRequest/index.html
Step 3: Streamer.bot WebSocket Server
This is required for chat commands to communicate with the web player.
- In Streamer.bot, go to Servers/Clients → WebSockets → Server.
- Set the Port to
8080(or your preferred port). - Check Auto Start and click Start Server.
Step 4: Import Actions to Streamer.bot
- Click the Import button at the top of Streamer.bot.
- Paste the following import code into the Import String box and click Import:
CLICK HERE TO SHOW IMPORT CODE
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
Step 5: Final Configuration
- Open your browser and go to
http://localhost:7474/betterSongRequest/index.html(or whatever you set up in Step 2). - Follow the built-in, interactive tutorial.
- You will need a free YouTube Data API v3 key from Google Cloud Console (instructions provided inside the app).
Step 6: Widget (Optional)
- Open Settings > General > OBS Widget Configuration, copy the generated URL, and paste it into an OBS Browser Source. The link automatically uses your WebSocket port and password settings.
- Set your preferred resolution. Recommended: 400x200px
Configuration
Web Interface Configurations
- Open your browser and go to
http://localhost:7474/betterSongRequest/index.html(or whatever path you set up in Step 2). - Follow the built-in, interactive tutorial popup on your first visit.
- Click the API Setup button. You will need to generate a free YouTube Data API v3 key from Google Cloud Console. Follow the step-by-step instructions provided directly inside the app to get it. Your API key is saved locally in your browser.
- Manage your background music by clicking
Manage Playlists and pasting links to any YouTube playlists.
Commands
| Command | Description |
|---|---|
| !sr [link/title] | Adds a song to the request queue. |
| !skipvote | starts voting to skip the song |
| !skip | Skips the currently playing track. |
| !play !stop !pause | Controls the currently playing track. |
| !wrongsong | Removes the last requested song by the user from the queue. |
| !volume [1-100] | Changes the volume of the player. |
| !when | to show when the requesting viewer’s nearest queued song will play. |
| !queue | to show the current request/manual song plus the next 10 request/manual song titles. |


