From a3e3d2c9506d17b3e19e205535ec263ee75178c9 Mon Sep 17 00:00:00 2001 From: Max Kellermann Date: Tue, 14 Oct 2008 22:38:14 +0200 Subject: command: added command "idle" "idle" waits until something noteworthy happens on the server, e.g. song change, playlist modified, database updated. This allows clients to keep up to date without polling. --- doc/COMMANDS | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'doc/COMMANDS') diff --git a/doc/COMMANDS b/doc/COMMANDS index 19ad373b1..718dcf24e 100644 --- a/doc/COMMANDS +++ b/doc/COMMANDS @@ -265,6 +265,27 @@ volume change volume by amount _change_ NOTE: volume command is deprecated, use setvol instead +idle + 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 updated + 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 waits 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 a new + command. + + COMMAND LIST ------------ -- cgit v1.2.3