Skip to content

Remote Services

A common streaming configuration is to have more than one computer involved, such as one computer working as the DJ machine and one computer for processing the stream. In some very advanced configurations, there might even be more than one DJ on different computers swapping back and forth!

What's Now Playing supports a configuration where each setup has their own app configuration running. One or more installations on DJ computers send the track information to a central one. That central one will then perform any additional lookups and send the output to anything configured such as Twitch.

Instructions

Server Side

remote-source-selection

  1. Open Settings from the What's Now Playing icon
  2. Select Core Settings->Source from the left-hand column
  3. Select Remote from the list of available input sources
  4. Configure the webserver and optionally set a secret

Client Side

remote-source-settings

  1. Open Settings from the What's Now Playing icon
  2. Select Output & Display->Remote Output from the left-hand column
  3. Enable it
  4. Set Server to the hostname or IP address of the server computer
  5. Set Port to match the server's webserver port
  6. Set Secret if the server has one configured
  7. Configure your DJ software as usual (Core Settings->Source and Input Sources)

NOTE: Some content, such as cover art, will not be sent to the remote server.

Client Configuration Notes

Turn off these services on client computers to avoid conflicts:

  • Artist Extras
  • Discord
  • Kick Chat
  • Twitch (Chat and Requests)

Recognition services (like AcoustID) must run on the client computer since they need local file access.

DJ Software Integration Examples

Some DJ software can send track information directly to What's Now Playing via HTTP requests:

MegaSeg (Logging → Send track info to server):

http://localhost:8899/v1/remoteinput?title=%Title%&artist=%Artist%&album=%Album%&year=%Year%&duration=%LengthSeconds%&bpm=%BPM%&composer=%Composer%&lyricist=%Lyricist%&publisher=%Publisher%

Radiologik (Publishing → Network & Serial → GET URL):

http://localhost:8899/v1/remoteinput?title=<t>&artist=<a>&album=<l>&isrc=<i>&composer=<comp>&publisher=<p>&year=<y>&duration=<s>&comment=<c>

Replace localhost:8899 with your server's hostname and webserver port. If a secret is configured, add &secret=your_secret_key to the URL.

Advanced API Usage

For detailed API documentation including request/response formats, authentication, and validation details, see the API Reference.