nowplaying-cli

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

Usage

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
next	skip to next track
previous	go to previous track

Examples

Available properties

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

Homebrew Install

TODO

Build

make