Added in 3.2

$play([nick|channel,]N)

Returns information about the /play queue.

See also /play, $filename, $pnick, on PLAYEND.

Parameters

Parameter Description
nick|channel The nick or channel where the file is playing.
N If N = 0, number of playing files, otherwise the Nth playing file.

Properties

Property Description
type Returns the type of the request, "topic" if you are using /play -t, otherwise "file".
.fname Returns the complete filename used for the play request.
.topic Returns the name of the topic if you used /play -t.
.pos Returns the number of the line that play request is at, (the next line to be played).
.lines Returns the total number of lines in the file being played.
.delay Returns the delay used for the play request (default to 1000).
.status Returns the status of the play request, "playing" or "queued".

Example

; Print the filename of the current playing file.
//echo -ag $play(1).fname

; Print the filename of first queued file matching channel '#chan'.
//echo -ag $play(#chan, 1).fname