Before you start

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

  1. Open the music website. Visit https://music.163.com/ and sign in.
  2. Open Choral Connector. Click its toolbar icon while the NetEase Cloud 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 NetEase Cloud Music from Choral

Choral reads the song information and playback state from the NetEase Cloud Music web player. Select NetEase Cloud Music in Choral before using the floating controls when multiple browser services are open.

Open Choral's music-source menu and select NetEase Cloud 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
  • Shuffle
  • Repeat
Limited controls: Like and unlike are not currently supported reliably for NetEase Cloud Music, so Choral keeps the heart disabled.

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

Choral does not currently send NetEase Cloud Music's like or collection action. The heart remains visible but disabled so the player layout stays consistent across sources.

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 Limited Support means

NetEase Cloud Music has Limited Support. Playback, previous and next, seeking, shuffle, and repeat are available, while likes are not supported.

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 website is playing but no song appears

Make sure playback is running in the main music.163.com player, refresh the page after enabling access, and reopen Choral Connector.

The heart is gray

This is expected. Like and unlike are not part of Choral's NetEase Cloud Music integration.

A control stops responding after navigation

NetEase can rebuild its player when changing sections. Refresh the page, start a track, and let Choral Connector rediscover the 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 NetEase Cloud 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