.\" rpld-*.1:

.TH "rpld-tools" "1" "May 2012" "rpld-tools" "System User's Manual: rpld-tools"

.SH NAME

rpld-tools \- RoarAudio PlayList Daemon control programs

.SH SYNOPSIS

rpld-next \-\-ifcurple PLE

rpld-ctl [COMMON OPTIONS] COMMAND [arg]

rpld-queueple [COMMON OPTIONS] [\-\-pos {first|last|POS]] PLE [PLI]

rpld-listq [COMMON OPTIONS] [PLI]

rpld-setpointer [COMMON OPTIONS] POINTER PLE [PLI]

rpld-listplaylists [COMMON OPTIONS] [{\-\-tree|\-\-flat}]

rpld-import [COMMON OPTIONS] PLI TYPE FILE

.SH DESCRIPTION

The RoarAudio PlayList Daemon is a daemon which manages playlists and can play
files or streams from those lists using a RoarAudio Sound Server.

This is a set of Perl based tools to do simple control of the server.

The following tools are supported:

.TP
\fBrpld-next \-\-ifcurple PLE\fR
Skip current song.

if \-\-ifcurple and a PLE is given the song is only skipped if the currently played
song matches the given PLE.

.TP
\fBrpld-ctl [COMMON OPTIONS] COMMAND [arg]\fR
This command can alter different parts of the current rpld state.
This included playback state as well as some playlist manipulation.

Possible commands are:

.RS

.TP
\fBpause\fR
Pause playback.

.TP
\fBunpause\fR
Unpause playback.

.TP
\fBtogglepause\fR
If playback is paused unpause, if not pause.

.TP
\fBvolume VOL\fR
Set volume to VOL.
VOL must be in range 0%..100% or 0..65535.

.TP
\fBplay\fR
Start playback.

.TP
\fBstop\fR
Stop playback.

.TP
\fBnext\fR
Play next track.

.TP
\fBprev\fR
Play previous track.

.TP
\fBstore\fR
Save current state to store.

.TP
\fBaddplaylist PLAYLIST\fR
Add a new playlist.

.TP
\fBdelplaylist PLAYLIST\fR
Delete a playlist.

.RE

.TP
\fBrpld-queueple [COMMON OPTIONS] [\-\-pos {first|last|POS]] PLE [PLI]\fR
Queue the song PLE form playlist PLI. If no playlist is given all playlists are searched.
A position where to queue to can optionally be given.

.TP
\fBrpld-listq [COMMON OPTIONS] [PLI]\fR
List content of queue or given playlist PLI.

.TP
\fBrpld-setpointer [COMMON OPTIONS] POINTER PLE [PLI]\fR
Set pointer POINTER to a given target PLE.
If no playlist (PLI) is given Main Queue is used.

.TP
\fBrpld-listplaylists [COMMON OPTIONS] [{\-\-tree|\-\-flat}]\fR
List all known playlists.
Listing is done in correct tree view (default) or as flat view.

.TP
\fBrpld-import [COMMON OPTIONS] PLI TYPE FILE\fR
Import a playlist file FILE into a playlist PLI.
The type of the file is given as TYPE.

.SH "COMMON OPTIONS"
The following common options are supported:

.TP
\fB--help\fR
THis option shows a brief help.

.TP
\fB--server SERVER\fR
This option sets the server to connect to. This overrides the defaults.

.TP
\fB--queue QUEUE\fR
This sets the default queue for the current process.

.SH "SEE ALSO"
\fBrpld-deprecated\fR(1),
\fBrpld\fR(7),
\fBRoarAudio\fR(7).

.\" ll