Track Fly
Reference

The feed.

One HTTP server on port 8765, the same on a Mac and on Track Fly Server. Plain GET, JSON, open CORS, no token.

The fields.

Stable keys, sensible types, nothing nested. Values you can trust a display with.

KeyTypeMeaning
statestringplaying, paused, stopped or not_running
sourcestringmusic, spotify, roon or plex
title · artist · albumstringThe track, as the player names it
duration · positionsecondsTrack length and playhead, one decimal
progress0 – 1Position divided by duration, for progress bars
textstring“Artist - Title (Album)”, ready to show
text_asciistringThe same line in plain ASCII
zonestringRoon zone or Plex player, when there is one
track_number · track_countnumberPlace on the album, 0 when unknown
playlist · queue_index · queue_countstring · numberThe playlist playing and the place in it (Apple Music)
queue_remainingnumberTracks left in the queue (Roon), null when unknown
volume0 – 100Player or Roon zone volume, null when it can't be set
idstringChanges when the track changes
artwork_urlstring · nullThe album cover as a JPEG, served by Track Fly

Endpoints · port 8765

  • /nowThe current track as JSON.
  • /textOne line of text, empty when nothing plays.
  • /sourcesEvery enabled source at once.
  • /zonesWhat a display can follow: every source and Roon zone.
  • /control?action=playpause, next, prev, volume&value=40, seek&value=90 (to a second) or seekby&value=-10. Roon, Apple Music and Spotify; Plex can't be controlled yet.
  • /artworkThe cover of the current track (JPEG, up to 640 px).
  • /historyRecently played, newest first: ?limit=20, &zone= or &source=. A track counts once it has played 20 s.
  • /displayA full-screen now-playing page for any browser on your network, in the display’s look, or as a turntable or a cassette.
  • /displaysThe Track Fly displays that read this feed.
  • /healthIs it up: version, sources, Roon and Plex status.
  • /settingsTrack Fly Server only: its settings page.

?ascii=1 on any endpoint turns Sigur Rós into Sigur Ros. &source=plex pins one source, &zone=Kitchen follows one Roon zone. Track Fly announces itself on the network as _trackfly._tcp, so a display can find it even after its address changes.

Mac or server.

Same port, same JSON, same displays. What differs is what each can reach.

Track Fly for MacTrack Fly Server
Runs onmacOS 15 or later, menu barWindows (tray icon), Linux, Docker
SourcesApple Music, Spotify, Roon, PlexRoon, Plex
ControlsRoon, Apple Music, SpotifyRoon
SettingsSettings window/settings in a browser, config.json, environment variables
UpdatesItself and your displaysDownload a new version; Docker: docker pull