Apple Music on your Mac, displayed beautifully on your TV.
How it works
A normal website cannot directly inspect Apple Music on macOS. The Mac companion acts as the local bridge.
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.
- Open Now Playing Bridge.app.
Launch it like any other Mac app. - Approve the first-launch security prompt if macOS shows one.
- Leave the bridge running.
A menu-bar version is ideal because it stays out of the way.
Allow Music access
macOS may ask whether Now Playing Bridge can access the Music app. This permission is required for automatic track detection.
- Open System Settings.
- Go to Privacy & Security.
- Open Automation.
- 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.
| Component | Role |
|---|---|
| Cloudflare Pages | Hosts the full-screen Now Playing / personal media interface. |
| Now Playing Bridge.app | Reads Apple Music locally and exposes the current playback state to the display. |
| Safari or Chrome | Runs the display page and receives updates. |
Start the display
- Open Apple Music on the Mac.
- Open Now Playing Bridge.app.
- Open your Cloudflare Pages display.
- Play a song in Apple Music.
- 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.
- Open Control Center on your Mac.
- Choose Screen Mirroring.
- Select the TV or Apple TV.
- 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.