cplay(1) a front-end for various audio players


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


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


restricted mode
Toggles playlist
repeat mode
Toggles playlist
random mode
Toggles PCM and MASTER (default) volume control


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

/etc/cplayrc - Optional configuration file.

~/.cplayrc - Optional configuration file.


Ulf Betlehem <[email protected]>


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