Class CurrentPlaylistCommands

Adds the file or directory uri to the playlist (directories add recursively).

Adds a song to the playlist (non-recursive) and returns the song id. uri is always a single file or URL.

Adds a tag to the specified song. Editing song tags is only possible for remote songs. This change is volatile: it may be overwritten by tags received from the server, and the data is gone when the song gets removed from the queue.

Clears the current playlist.

Removes tags from the specified song. If tag is not specified, then all tag values will be removed. Editing song tags is only possible for remote songs.

Deletes a song from the playlist.

Deletes the song with the given songid from the playlist.

Deletes a song range from the playlist.

Moves the song at from to to in the playlist.

Moves the song with the given songid to to the playlist. If to is negative, it is relative to the current song in the playlist (if there is one).

Moves the range of songs from start to end to to in the playlist.

Displays changed songs currently in the playlist since version. Start and end positions may be given to limit the output to changes in the given range. To detect songs that were deleted at the end of the playlist, use playlistlength returned by status command.

Displays changed songs currently in the playlist since version. This function only returns the position and the id of the changed song, not the complete metadata. This is more bandwidth efficient. To detect songs that were deleted at the end of the playlist, use playlistlength returned by status command.

Finds songs in the current playlist with strict matching.

Gets info for the song with the specified songid in the playlist.

Gets info for all songs or a single song in the playlist.

Gets info for a range of songs in the playlist.

Searches case-insensitively for partial matches in the current playlist.

Set the priority of the specified songs. A higher priority means that it will be played first when "random" mode is enabled. A priority is an integer between 0 and 255. The default priority of new songs is 0.

Same as prio, but address the songs with their songid.

Specifies the portion of the song that shall be played. start and end are offsets in seconds (fractional seconds allowed); both are optional. Omitting both means "remove the range, play everything". A song that is currently playing cannot be manipulated this way.

Shuffles the current playlist. start and end is optional and specifies a range of songs.

Swaps the positions of song1 and song2.

Swaps the positions of song1 and song2 (both songids).