nowplaying-cli is a macOS command-line utility for retrieving currently playing media, and simulating media actions.
Use nowplaying-cli to get song information and play/pause your media through an easy to use CLI!
Disclaimer: nowplaying-cli uses private frameworks, which may cause it to break with future macOS software updates.
Tested and working on:
- Ventura 13.1, 13.2, 13.3, 13.6
- Sonoma 14.4
You can install nowplaying-cli using Homebrew.
brew install nowplaying-cli
Clone the repository and run make
to build the binary. You can then move the binary to your desired location.
make
mv nowplaying-cli ~/.local/bin
nowplaying-cli <cmd>
command | description |
---|---|
get [propName1 propName2 ... ] | get now playing media properties |
get-raw | get all non-nil now playing media properties in dictionary format |
play | play the currently playing media regardless of current state |
pause | pause the currently playing media regardless of current state |
togglePlayPause | toggle play/pause based on current state |
seek | seek to a specific time in the currently playing media |
next | skip to next track |
previous | go to previous track |
native | nowplaying-cli |
---|---|
kMRMediaRemoteNowPlayingInfoTotalDiscCount | totalDiscCount |
kMRMediaRemoteNowPlayingInfoShuffleMode | shuffleMode |
kMRMediaRemoteNowPlayingInfoTrackNumber | trackNumber |
kMRMediaRemoteNowPlayingInfoDuration | duration |
kMRMediaRemoteNowPlayingInfoRepeatMode | repeatMode |
kMRMediaRemoteNowPlayingInfoTitle | title |
kMRMediaRemoteNowPlayingInfoPlaybackRate | playbackRate |
kMRMediaRemoteNowPlayingInfoArtworkData | artworkData |
kMRMediaRemoteNowPlayingInfoArtworkDataWidth | artworkDataWidth |
kMRMediaRemoteNowPlayingInfoArtworkDataHeight | artworkDataHeight |
kMRMediaRemoteNowPlayingInfoAlbum | album |
kMRMediaRemoteNowPlayingInfoTotalQueueCount | totalQueueCount |
kMRMediaRemoteNowPlayingInfoArtworkMIMEType | artworkMIMEType |
kMRMediaRemoteNowPlayingInfoMediaType | mediaType |
kMRMediaRemoteNowPlayingInfoDiscNumber | discNumber |
kMRMediaRemoteNowPlayingInfoTimestamp | timestamp |
kMRMediaRemoteNowPlayingInfoGenre | genre |
kMRMediaRemoteNowPlayingInfoQueueIndex | queueIndex |
kMRMediaRemoteNowPlayingInfoArtist | artist |
kMRMediaRemoteNowPlayingInfoDefaultPlaybackRate | defaultPlaybackRate |
kMRMediaRemoteNowPlayingInfoElapsedTime | elapsedTime |
kMRMediaRemoteNowPlayingInfoTotalTrackCount | totalTrackCount |
kMRMediaRemoteNowPlayingInfoIsMusicApp | isMusicApp |
kMRMediaRemoteNowPlayingInfoUniqueIdentifier | uniqueIdentifier |