Now Playing Bridge macOS + Cloudflare Pages
Now Playing Bridge

Apple Music on your Mac, displayed beautifully on your TV.

A lightweight macOS companion reads the song currently playing in Apple Music and sends that information to your personal web display.
No Spotify No API key No Terminal Cloudflare Pages

How it works

A normal website cannot directly inspect Apple Music on macOS. The Mac companion acts as the local bridge.

Apple MusicCurrent track
Mac BridgeReads playback metadata
Web DisplayCloudflare Pages
Your TVFullscreen / AirPlay

Local music access

The bridge reads title, artist, album, duration, playback position and state from Music on your Mac.

Web-based display

Your polished full-screen interface stays on Cloudflare Pages and can be updated independently.

Install the Mac app

The final bridge should be a normal macOS application. You should not need to open Terminal or type commands.

  1. Open Now Playing Bridge.app.
    Launch it like any other Mac app.
  2. Approve the first-launch security prompt if macOS shows one.
  3. Leave the bridge running.
    A menu-bar version is ideal because it stays out of the way.
No Terminal required The earlier Terminal helper was only a prototype. The intended experience is a regular Mac application.

Allow Music access

macOS may ask whether Now Playing Bridge can access the Music app. This permission is required for automatic track detection.

  1. Open System Settings.
  2. Go to Privacy & Security.
  3. Open Automation.
  4. Allow Now Playing Bridge to access Music.

Exact labels can vary slightly by macOS version.

Cloudflare Pages setup

Your visual player can be hosted at a normal pages.dev address while the bridge runs locally on the Mac.

ComponentRole
Cloudflare PagesHosts the full-screen Now Playing / personal media interface.
Now Playing Bridge.appReads Apple Music locally and exposes the current playback state to the display.
Safari or ChromeRuns the display page and receives updates.
Important Cloudflare Pages alone cannot read Music.app. The Mac bridge needs to be running whenever automatic Now Playing data is required.

Start the display

  1. Open Apple Music on the Mac.
  2. Open Now Playing Bridge.app.
  3. Open your Cloudflare Pages display.
  4. Play a song in Apple Music.
  5. Press Start Display or Fullscreen.

The display should update automatically when the song changes, pauses, resumes or seeks.

AirPlay to your TV

Use macOS Screen Mirroring / AirPlay to put the full-screen display on an Apple TV or compatible television.

  1. Open Control Center on your Mac.
  2. Choose Screen Mirroring.
  3. Select the TV or Apple TV.
  4. Enter fullscreen in the display site.

A website cannot silently force an AirPlay destination. The TV is chosen through macOS.

Privacy

No Spotify login

No Spotify account, OAuth connection or developer key is required.

No Apple password

The bridge never needs your Apple Account password.

Local playback access

The track metadata comes directly from Music on the same Mac.

Personal display

The system is designed for your own Mac / TV display workflow.

Troubleshooting

Nothing Playing

Confirm Apple Music is actually playing on the same Mac running Now Playing Bridge.

The bridge cannot read Music

Check System Settings → Privacy & Security → Automation and enable access to Music.

The Cloudflare page is not updating

Make sure Now Playing Bridge.app is currently running.

Music is only playing on my iPhone

The Mac bridge reads Music running on that Mac. Playback running only on another Apple device is not automatically visible to it.

Current limitations

  • A browser-only website cannot directly read system-wide Apple Music playback from macOS.
  • The bridge must run on the same Mac whose Music app is being monitored.
  • Cloud-library album artwork may need a separate fallback/retrieval strategy because Music scripting is not equally reliable for every track.
  • iPhone/iPad-only playback is more restricted than the Mac workflow.
Reliability rule If some metadata is unavailable, the display should fall back gracefully rather than inventing or showing incorrect information.