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)