table of contents
| MPRIS-CTL(1) | General Commands Manual | MPRIS-CTL(1) |
NAME¶
mpris-ctl - MPRIS media-player control utility
SYNOPSIS¶
mpris-ctl [OPTIONS...] [COMMAND] [format string]
DESCRIPTION¶
mpris-ctl is a control utility for any media-player that conforms to the MPRIS D-Bus Interface Specification[1]
OPTIONS¶
--player active | inactive | <name,...>
Specifies which players the command should be addressed
to. The valid values are:
active
all players that are currently in Playing
state.
inactive
all players that are currently in Stopped or
Paused state.
<name...>
specific player names, separated by spaces.
If the option is absent we consider all the players, active and inactive.
COMMANDS¶
help
This help message
play
Begin playing
pp
Toggle play or pause
pause
Pause the player
stop
Stop the player
next
Change to the next track play-list
prev
Change to the previous track in the play-list
status
Get the playback status. Equivalent to the info
%play_status action
list
Get the name of the running player(s). Equivalent to the
info %player_name action
info [format string]
Print information about the current track. format
string can include any of the following FORMAT SPECIFIERS.
FORMAT SPECIFIERS¶
%player_name
prints the media-player's name
%track_name
prints the track's name
%track_number
prints the track number
%track_length
prints the track length in seconds
%artist_name
prints the artist's name
%album_name
prints the album's name
%album_artist
prints the album's artist
%art_url
prints the URL of the cover art image
%play_status
prints the playback status
%shuffle
prints the shuffle mode
%volume
prints the volume level
%loop_status
prints the loop status
%position
prints the track's position in seconds
%bitrate
prints the track's bit-rate
%comment
prints the track's comment
%full
prints all available information
EXAMPLE¶
mpris-ctl info %full
Player name: Spotify Play status: Playing Track: Song 2 Artist: Blur Album: Blur: The Best Of Album Artist: Blur Art URL: https://open.spotify.com/image/7731a6d23ed9f82ea94e89b248450eb00f044a1b Track: 2 Length: 121.88s Volume: 0.00 Loop status: None Shuffle: false Position: 0.00s Bitrate: 0 Comment:
NOTES¶
1. MPRIS D-Bus Interface Specification
| 2022-12-04 |