Before you start

Choral is a floating remote control for macOS, not a streaming service. YouTube Music 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 YouTube Music until you explicitly enable that website.

1. Install Choral Connector

  1. Install Choral on your Mac. Download it directly or install it from the Mac App Store, then open the app.
  2. Add Choral Connector to Chrome. Open the Chrome Web Store listing and choose Add to Chrome.
  3. Keep the extension available. Open Chrome's Extensions menu and pin Choral Connector if you want its icon to stay visible in the toolbar.
The browser extension cannot be used by itself. The Choral app must be running on the same Mac for the floating player to receive track information and send controls.

2. Enable YouTube Music in Chrome

  1. Open the music website. Visit https://music.youtube.com/ and sign in.
  2. Open Choral Connector. Click its toolbar icon while the YouTube Music tab is active.
  3. 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.
  4. 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 YouTube Music from Choral

Once YouTube Music is connected, Choral mirrors the active track's artwork, title, artist, elapsed time, and duration. The floating panel can stay above your other windows, so you can keep working while controlling the browser player.

Open Choral's music-source menu and select YouTube Music. 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
  • Like and unlike
  • 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 the heart in Choral to use YouTube Music's like action. A liked song is added to your YouTube Music likes in the same way as clicking the thumbs-up control on the website. Click it again to remove the like. The state shown in Choral follows the state reported by YouTube Music.

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

YouTube Music is a Fully Supported source in Choral. Its play, pause, previous, next, seeking, like, shuffle, and repeat controls are available from the floating panel. Website updates can occasionally affect an integration; Choral keeps unavailable controls visible but disabled when a capability cannot be used.

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

The source does not appear in Choral

Play a song, confirm that Choral is running, then reopen the extension popup. It should say that Choral recognizes and controls YouTube Music.

The extension says Enabled but Choral shows nothing

Refresh the YouTube Music tab once after granting permission, start playback, and make sure YouTube Music is selected from Choral's music-source menu.

The heart does not match the website

Wait for the current track to finish loading, then click once. Choral waits for YouTube Music to report the resulting state rather than guessing.

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 YouTube Music?

Install Choral and Choral Connector, enable the website, and start a track. Your browser keeps playing; Choral becomes the remote.

Download Choral Install the extension