From Gentoo Wiki
Jump to: navigation, search

This article is a stub. You can help by expanding it.

cmus is a ncurses based music player with support for remote control. It uses plugins to support a multitude of media formats and works with many audio systems.


USE flags

USE flags for media-sound/cmus A ncurses based music player with plugin support for many formats

ao Use libao audio output library for sound playback global
cddb Access cddb servers to retrieve and submit information about compact disks global
cdio use libcdio for CD support local
cue enable CUE sheet parsing local
discid enable reading the ID of the inserted CD local
flac Add support for FLAC: Free Lossless Audio Codec global
mad Add support for mad (high-quality mp3 decoder library and cli frontend) global
mikmod Add libmikmod support to allow playing of SoundTracker-style music files global
modplug Add libmodplug support for playing SoundTracker-style music files global
mp4 Support for MP4 container format global
musepack Enable support for the musepack audio codec global
opus Enable Opus audio codec support global
pidgin install support script for net-im/pidgin local
tremor use libivorbis from media-libs/tremor instead of media-libs/libvorbis local
vorbis Add support for the OggVorbis audio codec global
wavpack Add support for wavpack audio compression tools global


root #emerge --ask media-sound/cmus


Set the password for remote control:

set password=password

Set output plugin:

set output_plugin=pulse

Possible settings:

  • pulse
  • alsa
  • oss
  • sndio


As a server

Start in a detached app-misc/screen session

user $screen -d -m cmus --listen

The default setting is to listen on port 3000

user $cmus-remote --server --passwd password
For some reason passing localhost to cmus-remote does not work.

We will be ably to enter commands from standard input such as:



(Remove this section if not applicable.)


(Troubleshoot issues in this section. Separate issues by best describing the error with a new section name. Remove if no issues are known.)

Issue 1

When X happens, Y is how you fix it.

See also

  • Article_name - (Link to related Gentoo Wiki articles using bullet points for each link in this section; each link should be local to the Wiki. Use a dash to separate the link from a reason why the link was decided upon.)

External resources

  • (Link to external resources (outside the Wiki) using bullet points in this section. It is common for the information in this section to full sentences that are links.)


(Optional section. Remove this section if references are not used. This section is used to cite factual information. This information is found outside the Gentoo Wiki and used to back up truth claims. The actual references themselves still be littered throughout the main article.)


look at how tmux or screen handle keys