User:jepio/cmus

From Gentoo Wiki
Jump to: navigation, search

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

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.

Installation

USE flags

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

aac Enable support for MPEG-4 AAC Audio global
alsa Add support for media-libs/alsa-lib (Advanced Linux Sound Architecture) global
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
debug Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces global
discid enable reading the ID of the inserted CD local
examples Install examples, usually source code global
ffmpeg Enable ffmpeg/libav-based audio/video codec support global
flac Add support for FLAC: Free Lossless Audio Codec global
jack Add support for the JACK Audio Connection Kit global
libsamplerate Build with support for converting sample rates using libsamplerate 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 support for media-libs/opusfile local
oss Add support for OSS (Open Sound System) global
pidgin install support script for net-im/pidgin local
pulseaudio Add support for PulseAudio sound server global
tremor use libivorbis from media-libs/tremor instead of media-libs/libvorbis local
unicode Add support for Unicode global
vorbis Add support for the OggVorbis audio codec global
wavpack Add support for wavpack audio compression tools global

Emerge

root #emerge --ask media-sound/cmus

Configuration

Set the password for remote control:

CODE
set password=password

Set output plugin:

CODE
set output_plugin=pulse

Possible settings:

  • pulse
  • alsa
  • oss
  • sndio

Usage

As a server

Start in a detached app-misc/screen session

user $screen -d -m cmus --listen 0.0.0.0

The default setting is to listen on port 3000

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

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

CODE
player-next
player-play
player-pause


Invocation

(Remove this section if not applicable.)

Troubleshooting

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

References

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

TODO:

look at how tmux or screen handle keys