Table of Contents
For manipulating playlists and playing, there are two sets of commands. One set uses the song id of a song in the playlist, while another set uses the playlist position of the song. The commands using song ids should be used instead of the commands that manipulate and control playback based on playlist position. Using song ids is a safer method when multiple clients are interacting with MPD.
clearerror
Clears the current error message in status (this is also accomplished by any command that starts playback).
currentsong
Displays the song info of the current song (same song that is identified in status).
idle
[SUBSYSTEMS
...]
[1] Waits until there is a noteworthy change in one or more of MPD's subsystems. As soon as there is one, it lists all changed systems in a line in the format changed: SUBSYSTEM, where SUBSYSTEM is one of the following:
database: the song database has been modified after update.
stored_playlist: a stored playlist has been modified, renamed, created or deleted
playlist: the current playlist has been modified
player: the player has been started, stopped or seeked
mixer: the volume has been changed
output: an audio output has been enabled or disabled
options: options like
repeat
, random
,
crossfade
While a client is waiting for idle results, the server disables timeouts, allowing a client to wait for events as long as mpd runs. The idle command can be canceled by sending the command noidle (no other commands are allowed). MPD will then leave idle mode and print results immediately; might be empty at this time.
If the optional SUBSYSTEMS
argument is used,
MPD will only send notifications when something changed in
one of the specified subsytems.
Since MPD 0.14
status
Reports the current status of the player and the volume level.
volume
:
0-100
repeat
:
0 or 1
single
:
0 or 1
[2]
consume
:
0 or 1
[2]
playlist
:
31-bit unsigned integer, the playlist
version number
playlistlength
:
integer, the length of the
playlist
state
:
play, stop, or pause
song
:
playlist song number of the current
song stopped on or playing
songid
:
playlist songid of the current song
stopped on or playing
nextsong
:
[2]
playlist song number of the next
song to be played
nextsongid
:
[2]
playlist songid of the next song
to be played
time
:
total time elapsed (of current
playing/paused song)
bitrate
:
instantaneous bitrate in
kbps
xfade
:
crossfade in seconds
audio
:
sampleRate:bits:channels
updatings_db
:
job id
error
:
if there is an error, returns message
here
stats
Displays statistics.
artists
: number of artists
songs
: number of albums
uptime
: daemon uptime in seconds
db_playtime
: sum of all song
times in the db
db_update
: last db update in UNIX
time
playtime
: time length of music played