Skip to content

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.

  • A Spotify account (Free or Premium).
  • A Spotify Client ID saved during setup. If you skipped it, open Settings → Setup and re-run the wizard’s integrations step.
  1. Open the Music pane (say or type “open music” in the command bar, or click the music icon in the left toolbar).
  2. In the pane’s title bar, switch the source dropdown to Spotify.
  3. Click Connect Spotify. Your web browser opens Spotify’s sign-in page.
  4. Sign in and click Agree. The browser shows a success message — you can close that tab.
  5. 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.
  • 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.
  • 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.