---

4 Commands ¶

The primary interface for now-playing.el is the Transient menu now-playing-tmenu. It can be invoked via execute-extended-command M-x.

Listed below are commands to both control or get current information from the Music app.

now-playing-tmenu

Transient menu for now-playing.el.

The following commands are provided:

• Pause/Play (SPC)
• Previous (p) and Next (n) Track
• Open (launch) Music app (o)
• Increase (<up>) and Decrease (<down>) volume
• Refresh current track (r)
• Settings (,)

now-playing-set-state

Set Music app playback state.

now-playing-play

Play Music app.

Note if there is no current track, this AppleScript command will not succeed. If this occurs, switch to the Music app to directly select a track to play.

now-playing-pause

Pause Music app.

now-playing-playpause

Toggle play or pause Music app.

Note if there is no current track, this AppleScript command will not succeed. If this occurs, switch to the Music app to directly select a track to play.

now-playing-stop

Stop Music app.

Note this command will deselect the current track in the Music app, making the commands now-playing-play and now-playing-playpause ineffective. If this occurs, switch to the Music app and select a track to resume expected behavior.

now-playing-next-track

Next track Music app.

Note if this command is called when on the last track of the playlist or album will deselect the current track.

now-playing-previous-track

Previous track Music app.

Note if this command is called when on the first track of the playlist or album will deselect the current track.

now-playing-get-volume

Get Music app sound volume.

now-playing-set-volume

Set Music app sound volume to ARG.

now-playing-increase-volume

Increase Music app sound volume.

now-playing-decrease-volume

Decrease Music app sound volume.

now-playing-current-track

Get current track on Music app.

now-playing-launch-music

Launch Music app.

Command Variables ¶

The following customizable variables can be changed to preference:

now-playing-volume-delta

Change increment for sound volume (default 5).

now-playing-dismiss-menu-for-playpause

If non-nil, then toggling pause/play will dismiss the Transient menu now-playing-tmenu.

now-playing-menu-theme

Theme for menu descriptions.

Customize this variable to a theme of preference:

• SF Symbols (:sfsymbols)
• Unicode (:unicode)
• Text (:text)

Both Unicode and Text allow for usage on TTY frames on systems that do not support SF Symbols.

• Polling the Current Track