Before you start
Choral is a floating remote control for macOS, not a streaming service. Spotify Web Player continues playing in Chrome under your own account. Choral Connector sends the current track and supported controls to the Choral app through a local connection on your Mac.
You need macOS 15 or later, Google Chrome, the Choral app, and the free Choral Connector extension. The extension does not receive access to Spotify Web Player until you explicitly enable that website.
1. Install Choral Connector
- Install Choral on your Mac. Download it directly or install it from the Mac App Store, then open the app.
- Add Choral Connector to Chrome. Open the Chrome Web Store listing and choose Add to Chrome.
- Keep the extension available. Open Chrome's Extensions menu and pin Choral Connector if you want its icon to stay visible in the toolbar.
2. Enable Spotify Web Player in Chrome
- Open the music website. Visit https://open.spotify.com/ and sign in.
- Open Choral Connector. Click its toolbar icon while the Spotify Web Player tab is active.
- Enable this site. Click Enable Choral on this site, then approve Chrome's permission prompt. Choral requests access only to the music website you are enabling.
- Start a song. Play a normal track on the website. The popup should change to a Ready message after Choral recognizes the player.
3. Control Spotify Web Player from Choral
Spotify Web Player appears as its own source, separate from the Spotify desktop app. This matters when both are open: selecting Spotify Web Player tells Choral exactly which player should receive the next command.
Open Choral's music-source menu and select Spotify Web Player. This selection determines which source receives play, pause, and shortcut commands when several music apps or browser players are open at the same time.
- Play and pause
- Previous and next track
- Seek within a track
- Save and remove tracks
- Shuffle
- Repeat
You can also configure global shortcuts in Choral Settings. They work while you are using another app, so common actions do not require bringing Chrome or Choral to the front.
4. Like or favorite the current song
Click Choral's heart to save the current Spotify track to Your Library. Click it again to remove the track. This web-player integration uses the signed-in Spotify page and does not require the advanced Spotify API Client ID used by the desktop-app integration.
If the heart is gray and cannot be clicked, the current player context has not exposed a reliable like or favorite action. Choral deliberately disables unavailable actions instead of hiding controls or guessing where to click.
What Full Support means
Spotify Web Player is Fully Supported. Choral reads current track information, duration, playback position, artwork, saved state, shuffle, and repeat from the web player and sends commands back to that selected source.
Music websites can change their player interfaces and internal behavior. Choral's support label describes the current integration, but a future website update can temporarily affect one or more controls.
Troubleshooting
Choral controls the Spotify desktop app instead
Open Choral's music-source menu and select Spotify Web Player before pressing play. Source selection is sticky and routes commands to the source you chose.
Track information updates slowly
Refresh open.spotify.com after enabling the extension, then start a new track. Choral Connector observes Spotify's player state and should update as soon as the page reports the change.
Seeking does not work
Wait until Spotify reports a valid total duration, then drag Choral's progress bar. Some advertisements and short interstitials do not allow seeking.
Choral Connector says the app is not connected
Open the Choral app and leave it running. The extension connects only to a local address on your Mac. If the status does not recover, quit and reopen Choral, then reopen the extension popup.
Ready to control Spotify Web Player?
Install Choral and Choral Connector, enable the website, and start a track. Your browser keeps playing; Choral becomes the remote.