NAME

       cplay - a front-end for various audio players

SYNOPSIS

       cplay [-options] [ file | dir | playlist ] ...

DESCRIPTION

       cplay  is  a  front-end  for  various  audio  players.  It aims to provide a user-friendly
       interface with simple filelist and playlist control.  Invoking 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, cplay automatically adds  it  to  the  playlist  which  can  be
       accessed by pressing the tabulator key.

       Use 'h' to display the help window.

       Shell  command-lines are executed with tagged or current entries as positional parameters,
       which means that "$@" might be useful.

       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).

OPTIONS

       -n     Enable restricted mode

       -r     Toggles playlist repeat mode

       -R     Toggles playlist random mode

       -v     Toggles PCM and MASTER (default) volume control

SEE ALSO

       ogg123(1),  mpg123(1),  mpg321(1),  splay(1),  madplay(1),  mikmod(1),  xmp(1),   play(1),
       speexdec(1)

FILES

       /var/tmp/cplay_control - Optional remote control fifo.

       /etc/cplayrc - Optional configuration file.

       ~/.cplayrc - Optional configuration file.

AUTHOR

       Ulf Betlehem <flu@iki.fi>

BUGS

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

                                          November 2002                                  CPLAY(1)