Connect Spotify to Mastery HQ
Connecting Spotify links your account to the Music pane so you can play your library inside Mastery HQ. Sign-in happens in your web browser (your password never touches the app), and once connected, Spotify Premium accounts get a native full-track player — search, playlists, up-next queue, and volume — while Free accounts use Spotify’s embedded player with previews.
Prerequisites
Section titled “Prerequisites”- A Spotify account (Free or Premium).
- That’s it — Mastery HQ ships with a built-in Spotify app ID, so Connect Spotify works out of the box. If you prefer your own Spotify Developer app, paste its Client ID in Settings → Setup and it takes precedence. (If Spotify tells you your account “is not registered” with the built-in app, use your own Client ID — creating one takes two minutes at developer.spotify.com — or contact us to be added.)
- Open the Music pane (say or type “open music” in the command bar, or click the music icon in the left toolbar).
- In the pane’s title bar, switch the source dropdown to Spotify.
- Click Connect Spotify. Your web browser opens Spotify’s sign-in page.
- Sign in and click Agree. The browser shows a success message — you can close that tab.
- Back in Mastery HQ, the pane header shows Connected as <your name> · Premium (or Free). You have up to 10 minutes to finish signing in before the connection attempt expires.
What you get after connecting
Section titled “What you get after connecting”- Premium: search Spotify from the pane, open Your Playlists, and play full tracks in the native now-playing card — art, previous/play/next, seek bar, volume and mute, and the up-next queue.
- Free: tracks open in Spotify’s embedded player with 30-second previews. Everything else in the Music pane (YouTube, stations, history) works the same.
Good to know
Section titled “Good to know”- The waveform next to the player is a music visualizer — it moves with playback but is not beat-synced to the track. That’s a Spotify API restriction, not a setting.
- If you reconnect after an update that adds permissions, the app may reload itself once to restart Spotify’s player cleanly. That’s expected.
If it didn’t work: see Spotify troubleshooting.
Frequently asked questions
Do I need Spotify Premium?
No. Free accounts get Spotify's embedded player with track previews. Premium unlocks the native full-track player inside the Music pane, with search, your playlists, an up-next queue, and volume controls.
Why does the Spotify login open in my web browser?
That's by design. Mastery HQ opens Spotify's login page in your system browser — the industry-standard OAuth flow for desktop apps — so your password is only ever typed into spotify.com, never into the app.