# Track Fly > Track Fly is a free macOS menu bar app that turns what is playing in Apple Music, Spotify, Roon or Plex into one JSON feed on your local network, for microcontrollers (ESP32, Arduino), Home Assistant, stream overlays and scripts. No cloud, no account. macOS 15 or later. Track Fly Server (beta) serves the same feed from Windows, Linux or Docker, for Roon and Plex. - Website: https://trackfly.stream - Download (signed and notarized, updates itself): https://trackfly.stream/download/Track-Fly.zip - Track Fly Server for Windows, Linux, Raspberry Pi and Docker (`ghcr.io/cryptooth/trackfly-server`): https://trackfly.stream/server/ - Docs (every field and endpoint): https://trackfly.stream/docs/ - Displays: https://trackfly.stream/displays/ - Display firmware for the Waveshare ESP32-S3-Touch-LCD-3.49: https://trackfly.stream/firmware/ (source: https://github.com/cryptooth/track-fly-waveshare) - OLED firmware for an ESP32-C3 with a 256x64 SSD1322: https://trackfly.stream/firmware/oled/ (source: https://github.com/cryptooth/track-fly-oled) ## The feed The app (or Track Fly Server) serves HTTP on port 8765 (for example http://my-mac.local:8765) and announces itself with Bonjour as `_trackfly._tcp`. CORS is open (`Access-Control-Allow-Origin: *`). Endpoints: - `/now`: the current track as JSON. - `/text`: one line of text, empty when nothing plays. - `/sources`: every enabled source at once. - `/zones`: every source and Roon zone a client can follow. - `/control?action=playpause|next|prev|volume&value=40`: control playback (Roon, Apple Music, Spotify). - `/artwork`: the cover of the current track as JPEG, at most 640 px. - `/display`: a full-screen now-playing page for any browser on the network. - `/health`: is it up. - `/settings`: Track Fly Server's settings page. Query options on any endpoint: `?ascii=1` returns plain ASCII strings (for 5x7 fonts), `&source=plex` pins one source, `&zone=Kitchen` follows one Roon zone. Main fields of `/now`: - `state`: `playing`, `paused`, `stopped` or `not_running` - `source`: `music`, `spotify`, `roon` or `plex` - `title`, `artist`, `album`: strings - `duration`, `position`: seconds; `progress`: 0 to 1 - `text`: "Artist - Title (Album)"; `text_ascii`: the same in ASCII - `zone`: Roon zone or Plex player - `track_number`, `track_count`, `playlist`, `queue_index`, `queue_count`, `queue_remaining` - `volume`: 0 to 100 or null - `id`: changes when the track changes - `artwork_url`: absolute URL of the cover JPEG, or null ## Home Assistant ```yaml sensor: - platform: rest name: Now Playing resource: http://my-mac.local:8765/now value_template: "{{ value_json.text }}" json_attributes: [state, source, title, artist, album, progress] scan_interval: 5 ``` ## Privacy The app collects nothing; the feed stays on the local network. It contacts trackfly.stream only to check for updates.