---
name: "cplay"
section: "1"
platform: "linux"
package: "cplay"
version: "1.50-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/cplay"
---

# cplay(1)

a front-end for various audio players

## 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)](/ogg123/1.md), [**mpg123**(1)](/mpg123/1.md), [**mpg321**(1)](/mpg321/1.md), [**splay**(1)](/splay/1.md), [**madplay**(1)](/madplay/1.md), [**mikmod**(1)](/mikmod/1.md), [**xmp**(1)](/xmp/1.md), [**play**(1)](/play/1.md), [**speexdec**(1)](/speexdec/1.md)

## 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.*