Scroll to navigation

CPLAY(1) General Commands Manual CPLAY(1)


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


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


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


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

/etc/cplayrc - Optional configuration file.

~/.cplayrc - Optional configuration file.


Ulf Betlehem <>


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

November 2002