FeaturesCompareGuidesPricingFAQ Buy $4 Download the free trial

What is MediaRemote on macOS?

Developer terms Published

All of glossary Try NotchStar in the browser Buy for $4

MediaRemote is a private Apple framework that holds the system’s Now Playing state: the title, artwork and play state of whatever is playing. The Control Center Now Playing tile reads from the same service. Because it is private, Apple does not publish documentation for it.

Why it matters

Any app that wants to show the current song for any player needs this state. Since macOS 15.4, third party processes can no longer read MediaRemote directly. Apple’s own tools remain entitled to it.

How NotchStar reads it

NotchStar uses the open source MediaRemoteAdapter, written by Jonas van den Berg and released under the BSD 3 clause license. The adapter is loaded by Apple’s own /usr/bin/perl, which still has the entitlement. It is bundled in the app but not linked into it. If the stream is silent or exits, NotchStar falls back to AppleScript for Music and Spotify.

The adapter process runs only while the Now Playing card is on screen, and stops when it is not.

Risk

A private API can change in a macOS update. NotchStar has a live test that fails loudly if the adapter stops working, and the AppleScript route covers Music and Spotify only. When a track has no duration, such as some radio items, the progress bar is left out.

Read how notch apps read now playing, the Now Playing feature page and music controls not working.

Keep reading.

How notch apps read what is playing, after macOS 15.4
Why showing the current song got harder in macOS 15.4, how open source adapters work around it, and the tradeoffs. Tested, with real findings.
Now playing, with real album art
See the song playing on your Mac with album artwork and controls in the notch. Live updates, and a progress bar when the player provides one.
Mac notch music controls not working: what to check first
Check the player, missing track information and Music or Spotify permissions before reinstalling a notch app. Learn which missing controls are expected.
What is AppKit?
AppKit is Apple's older framework for building Mac apps with windows, menus and events. Learn what it covers and why SwiftUI apps still use it.

More in Developer terms.

What is NSPanel?
NSPanel is the AppKit window class for auxiliary windows such as palettes and utility panels. Learn why a notch app uses a non activating one.
What is SwiftUI?
SwiftUI is Apple's framework for declaring an app's user interface in Swift code. Learn what it does, how it meets AppKit and how NotchStar uses both.
What is AppKit?
AppKit is Apple's older framework for building Mac apps with windows, menus and events. Learn what it covers and why SwiftUI apps still use it.
What is NSPasteboard?
NSPasteboard is the AppKit object that moves data to and from the Mac clipboard. Learn how apps read it and why clipboard managers poll change count.
What is hover intent?
Hover intent is a short delay before a hover opens something, so passing the pointer by does not trigger it. Learn how NotchStar tunes it at the notch.
What does open source mean?
Open source software publishes its source code under a license that lets others read and change it. Learn the definition and how it differs from closed source.
NotchStar app icon

Put your notch to work.

Buy it once for $4, activate it in a minute, and keep it. Not sure yet? Try every tool in the browser on the home page, or install the 7 day trial.

Buy NotchStar for $4 Try it in the browser