This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.

Please visit our production wiki at https://wiki.gentoo.org

User:jepio/cmus

From Gentoo Wiki (test)
Jump to:navigation Jump to: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 Ncurses based music player with plugin support for many formats

aac Enable support for MPEG-4 AAC Audio
alsa Add support for media-libs/alsa-lib (Advanced Linux Sound Architecture)
ao Use libao audio output library for sound playback
cddb Access cddb servers to retrieve and submit information about compact disks
cdio Use libcdio for CD support
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
discid Enable reading the ID of the inserted CD
elogind Enable MPRIS support via sys-auth/elogind
examples Install examples, usually source code
ffmpeg Enable ffmpeg/libav-based audio/video codec support
flac Add support for FLAC: Free Lossless Audio Codec
jack Add support for the JACK Audio Connection Kit
libsamplerate Build with support for converting sample rates using libsamplerate
mad Add support for mad (high-quality mp3 decoder library and cli frontend)
mikmod Add libmikmod support to allow playing of SoundTracker-style music files
modplug Add libmodplug support for playing SoundTracker-style music files
mp4 Support for MP4 container format
musepack Enable support for the musepack audio codec
opus Enable Opus audio codec support
oss Add support for OSS (Open Sound System)
pidgin Install support script for net-im/pidgin
pulseaudio Add sound server support via media-libs/libpulse (may be PulseAudio or PipeWire)
sndio Add support for media-sound/sndio
systemd Enable MPRIS support via sys-apps/systemd
tremor Use libivorbis from media-libs/tremor instead of media-libs/libvorbis
unicode Add support for Unicode
vorbis Add support for the OggVorbis audio codec
wavpack Add support for wavpack audio compression tools

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