Music

What it's for

• Showing what you're listening to without babysitting another tab.
• Letting chat queue songs with !sr right from the chat box.
• Keeping playback in sync across phone, desktop, and Spotify Connect speakers.

How to set it up

1. Connect Spotify in Connections. The widget uses your developer-app credentials to mint per-user refresh tokens — your Spotify account never leaves the worker.
2. Add one music source. That single source powers the widget appearance and the music command settings on this page.
3. Drop the browser source URL into OBS at 360×180 for Default or Slim, or larger for Boxy, Stacked, and Terminal skins.
4. Add the stream scene route if you use chat commands. It uses the same music source token. In OBS, set URL to the stream scene route, Width 1920, Height 1080, Local file off, and Page permissions to Advanced access to OBS.
5. Tune appearance + permissions below. Saving widget appearance updates the live source instantly. Command permissions sync on save.

FAQ

Why per-user Spotify credentials instead of one shared app?

Spotify's Developer App quotas are per-app, not per-user. Using a shared app means every streamer hitting the widget shares one rate-limit budget. Per-user credentials give each streamer their own quota and keep tokens scoped to a single account.

What chat commands does it support?

!sr queues a track via Spotify's queue API. Optional companions are !song / !nowplaying (echo the current track), !skip (skip; mods only by default), and !queue (peek the next item).

Why doesn't seek/scrub show in the bar smoothly?

The widget polls Spotify every 10 seconds and interpolates between polls. Manual seeks land on the next poll — usually within 5 seconds. If you scrub a lot, the bar may briefly catch up rather than animate.