meillo@0: .\" Copyright (C) 2000, 2002 Martin Michlmayr <tbm@cyrius.com>
meillo@0: .\" This manual is freely distributable under the terms of the GPL.
meillo@0: .\" It was originally written for Debian GNU/Linux (but may be used
meillo@0: .\" by others).
meillo@0: .\"
meillo@0: .TH CPLAY 1 "November 2002"
meillo@0: 
meillo@0: .SH NAME
meillo@0: .PP
meillo@0: cplay \- a front-end for various audio players
meillo@0: 
meillo@0: .SH SYNOPSIS
meillo@0: .PP
meillo@0: \fBcplay\fR [\-options] [ \fIfile\fP | \fIdir\fP | \fIplaylist\fP ] ...
meillo@0: 
meillo@0: .SH DESCRIPTION
meillo@0: .PP
meillo@0: .B cplay
meillo@0: is a front-end for various audio players. It aims to provide a
meillo@0: user-friendly interface with simple filelist and playlist
meillo@0: control.  Invoking
meillo@0: .B cplay
meillo@0: without any options puts you in the filelist in which you
meillo@0: can navigate around looking for audio files.  When you
meillo@0: specify an audio file,
meillo@0: .B cplay
meillo@0: automatically adds it to the playlist which can be accessed
meillo@0: by pressing the tabulator key.
meillo@0: .PP
meillo@0: Use 'h' to display the help window.
meillo@0: .PP
meillo@0: Shell command-lines are executed with tagged or current entries
meillo@0: as positional parameters, which means that "$@" might be useful.
meillo@0: .PP
meillo@0: Currently, the following audio formats are supported: MP3 (through
meillo@0: mpg321, splay, mpg123 or madplay), Ogg Vorbis (through ogg123), and
meillo@0: various module-formats (through mikmod and xmp).
meillo@0: 
meillo@0: .SH OPTIONS
meillo@0: .IP \fB\-n
meillo@0: Enable \fIrestricted\fI mode
meillo@0: .IP \fB\-r
meillo@0: Toggles playlist \fIrepeat\fP mode
meillo@0: .IP \fB\-R
meillo@0: Toggles playlist \fIrandom\fP mode
meillo@0: .IP \fB\-v
meillo@0: Toggles PCM and MASTER (default) volume control
meillo@0: 
meillo@0: .SH SEE ALSO
meillo@0: .PP
meillo@0: .BR ogg123 (1),
meillo@0: .BR mpg123 (1),
meillo@0: .BR mpg321 (1),
meillo@0: .BR splay (1),
meillo@0: .BR madplay (1),
meillo@0: .BR mikmod (1),
meillo@0: .BR xmp (1),
meillo@0: .BR play (1),
meillo@0: .BR speexdec (1)
meillo@0: 
meillo@0: .SH FILES
meillo@0: .PP
meillo@0: .I /var/tmp/cplay_control 
meillo@0: - Optional remote control fifo.
meillo@0: 
meillo@0: .I /etc/cplayrc
meillo@0: - Optional configuration file.
meillo@0: 
meillo@0: .I ~/.cplayrc
meillo@0: - Optional configuration file.
meillo@0: 
meillo@0: .SH AUTHOR
meillo@0: .PP
meillo@0: Ulf Betlehem <flu@iki.fi>
meillo@0: 
meillo@0: .SH BUGS
meillo@0: .PP
meillo@0: In order for either mp3info (ID3) or ogginfo to work,
meillo@0: both corresponding python modules have to be installed.
meillo@0: