.\" Copyright (C) 2000, 2002 Martin Michlmayr <tbm@cyrius.com>
.\" This manual is freely distributable under the terms of the GPL.
.\" It was originally written for Debian GNU/Linux (but may be used
.\" by others).
.\"
.TH CPLAY 1 "November 2002"

.SH NAME
.PP
cplay \- a front-end for various audio players

.SH SYNOPSIS
.PP
\fBcplay\fR [\-options] [ \fIfile\fP | \fIdir\fP | \fIplaylist\fP ] ...

.SH DESCRIPTION
.PP
.B cplay
is a front-end for various audio players. It aims to provide a
user-friendly interface with simple filelist and playlist
control.  Invoking
.B cplay
without any options puts you in the filelist in which you
can navigate around looking for audio files.  When you
specify an audio file,
.B cplay
automatically adds it to the playlist which can be accessed
by pressing the tabulator key.
.PP
Use 'h' to display the help window.
.PP
Shell command-lines are executed with tagged or current entries
as positional parameters, which means that "$@" might be useful.
.PP
Currently, the following audio formats are supported: MP3 (through
mpg321, splay, mpg123 or madplay), Ogg Vorbis (through ogg123), and
various module-formats (through mikmod and xmp).

.SH OPTIONS
.IP \fB\-n
Enable \fIrestricted\fI mode
.IP \fB\-r
Toggles playlist \fIrepeat\fP mode
.IP \fB\-R
Toggles playlist \fIrandom\fP mode
.IP \fB\-v
Toggles PCM and MASTER (default) volume control

.SH SEE ALSO
.PP
.BR ogg123 (1),
.BR mpg123 (1),
.BR mpg321 (1),
.BR splay (1),
.BR madplay (1),
.BR mikmod (1),
.BR xmp (1),
.BR play (1),
.BR speexdec (1)

.SH FILES
.PP
.I /var/tmp/cplay_control 
- Optional remote control fifo.

.I /etc/cplayrc
- Optional configuration file.

.I ~/.cplayrc
- Optional configuration file.

.SH AUTHOR
.PP
Ulf Betlehem <flu@iki.fi>

.SH BUGS
.PP
In order for either mp3info (ID3) or ogginfo to work,
both corresponding python modules have to be installed.