Before you start

Choral is a floating remote control for macOS, not a streaming service. QQ 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 QQ 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 QQ Music in Chrome

  1. Open the music website. Visit https://y.qq.com/n/ryqq_v2/player and sign in.
  2. Open Choral Connector. Click its toolbar icon while the QQ 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 QQ Music from Choral

Choral follows QQ Music's active web player and displays the current song, artist, artwork, duration, and playback position. The selected QQ Music source receives both panel commands and global shortcuts.

Open Choral's music-source menu and select QQ 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 Choral's heart to use QQ Music's favorite action for the current song. You must be signed in to QQ Music for the change to remain in your account.

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

QQ Music is Fully Supported in Choral, including playback, track navigation, seeking, likes, shuffle, and repeat in the main web player.

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

QQ Music does not appear as open

Use the main y.qq.com player page, refresh it after enabling permission, and start a full track before reopening Choral's source menu.

The heart does not update

Confirm that you are signed in and wait for QQ Music to finish loading the current song before clicking once.

Controls stopped after changing pages

QQ Music may replace its player during navigation. Return to the player page or refresh once so Choral Connector can attach to the new player.

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 QQ 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