YouTube Music integration

Connecting YouTube Music lets streamion.bot add requested videos to a YouTube playlist you own. The integration sits alongside Spotify as a second possible music provider; the active provider — set in Settings → Music — determines which connection streamion.bot uses for chat commands.

YouTube Music's API is more limited than Spotify's. streamion.bot can add tracks to a playlist and read what's in it, but YouTube does not offer a way to ask "what is currently playing?" or to remotely control playback. Practical consequences for streamers:

• !sr (song request) and !nexttracks work.
• !playlist works (shows the active playlist).
• !song, !skip, !playsong, !stopsong are Spotify-only. If your active provider is YouTube Music, these commands are not available — you play the active YouTube playlist yourself during the stream.

Connecting

The connection is managed centrally on Settings → Music (/settings/music), where both providers appear as cards next to each other.

1. Open /settings/music.
2. Pick YouTube Music as the active music provider at the top of the page if you have not done so already.
3. On the YouTube Music card, click Connect YouTube.
4. You are redirected to Google's authorization page. Approve the request.
5. You are redirected back. The card now shows Connected with the YouTube account's display name.

The OAuth scopes (the individual permissions Google is asked to grant) streamion.bot requests are: https://www.googleapis.com/auth/youtube, openid, and profile. The first scope is required to read and modify playlists; the other two are used to identify the connecting account.

Playlists page

The YouTube Music → Playlists page (/youtubemusic/playlists) is where you decide which YouTube playlist song requests are added to.

• Saved playlists (top section) — playlists imported from your YouTube library. Exactly one can be Active at a time; song requests are appended to that playlist.
• Your YouTube playlists (bottom section) — fresh from your YouTube library. Use the refresh control to reload.

Only playlists owned by the connected YouTube account can be activated for song requests. Playlists you only subscribe to (but did not create) cannot be written to.

Available row actions: View tracks, Activate / Deactivate, Delete (removes from streamion.bot, not from YouTube).

Song-request settings

The YouTube Music song-request settings appear on Settings → Music as a Song Requests · YouTube Music card, but only while YouTube Music is the active provider and the connection is healthy. Settings auto-save on change.

Channel-point song requests

Viewers can also request songs by redeeming a Twitch channel-point reward instead of (or alongside) the !sr command. streamion.bot creates and manages the reward; redeemed requests run through the same pipeline as !sr and are added to your active YouTube Music playlist.

Set it up on Settings → Music (/settings/music), in the Song requests via channel points card: an enable toggle, a reward name (default Song Request, up to 45 characters), and a channel-point cost (default 500). A viewer types their song into the reward's text box; successful redemptions are fulfilled, failed ones refund the points automatically. Enabling it also offers to disable !sr so requests come only via channel points — choose Keep both to keep the command too.

This needs a recently-added Twitch permission, so reconnect your broadcaster account on the Channel page to grant it.

Blacklist

The blacklist is managed at /settings/youtubemusic/blacklist and prevents specific channels or keywords from being added through !sr.

• Channel blacklist — enter the channel ID (the UC… string, 24 characters — find it in the channel's URL at youtube.com/channel/UC…) plus a display name of your choice (shown in the table; it's cosmetic and not used for matching). Everything that channel uploads is then blocked. Unlike the Spotify artist blacklist, there's no URL or @handle lookup here — paste the raw UC… ID.
• Keyword blacklist — case-insensitive match against the video title and uploader name. Useful for blanket bans on themes or sound-alike covers.

Blacklist entries are scoped to your workspace.

Chat commands while YouTube Music is active

Defaults (trigger, aliases, permission, cooldowns) can be overridden per channel on the Commands page.

Disconnecting

Click Disconnect on the YouTube Music card on /settings/music. streamion.bot revokes the tokens and removes the stored connection. To revoke streamion.bot's access on Google's side as well, visit myaccount.google.com/permissions.

Troubleshooting

• !sr says "Song requests are currently disabled." — Either YouTube Music is not the active provider in Settings → Music, or the Enable song requests switch is off, or the connection is in the Needs reauth state.
• !sr says "the active playlist isn't owned by the connected account" — Activate a playlist that the connected YouTube account owns; you cannot add tracks to a playlist someone else created.
• YouTube card shows "needs re-authorization" — The stored credentials could not be refreshed. Click Reconnect and walk the OAuth flow again. Common causes: the streamion.bot app was revoked in the Google account's security settings, or the account's password changed.
• A video gets through the explicit filter — Add the uploader's channel or a keyword to the blacklist on /settings/youtubemusic/blacklist.