cmus/ cmus

(v2.9.1) 3 months ago

C++

Shell

Python

View on GitHub

Need help with cmus?

Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

cmus

4.1K Stars

441 Forks

GNU General Public License v2.0

2.2K Commits

210 Opened issues

Description

Small, fast and powerful console music player for Unix-like operating systems.

Services available

Need anything else?

Contributors list

Readme

Warning: cmus is not actively maintained. For details, please see #856

cmus — C* Music Player

Name: cmus
Brand: cmus
SKU: //cmus/cmus
Rating: 4.347333333333333 (4126 reviews)

https://cmus.github.io/

Configuration

List available optional features

$ ./configure --help

Auto-detect everything

$ ./configure

To disable some feature, arts for example, and install to

$HOME

run

$ ./configure prefix=$HOME CONFIG_ARTS=n

After running configure you can see from the generated

config.mk

file what features have been configured in (see the

CONFIG_*

options).

Note: For some distributions you need to install development versions of the dependencies. For example if you want to use 'mad' input plugin (mp3) you need to install

libmad0-dev

(Debian) or

libmad-devel

(RPM) package. After installing dependencies you need to run

./configure

again, of course.

If you want to use the Tremor library as alternative for decoding Ogg/Vorbis files you have to pass

CONFIG_TREMOR=y

to the configure script:

$ ./configure CONFIG_VORBIS=y CONFIG_TREMOR=y

The Tremor library is supposed to be used on hardware that has no FPU.

Building

$ make

Or on some BSD systems you need to explicitly use GNU make:

$ gmake

Installation

$ make install

Or to install to a temporary directory:

$ make install DESTDIR=~/tmp/cmus

This is useful when creating binary packages.

Remember to replace

make

with

gmake

if needed.

Manuals

$ man cmus-tutorial

And

$ man cmus

Mailing List

To subscribe to [email protected] or view the archive visit http://lists.sourceforge.net/lists/listinfo/cmus-devel.

The mailing list now serves as an archive for old releases and issues. Please use the GitHub issues page for any problems, suggestions, or bug reports.

Reporting Bugs

Bugs should be reported using the GitHub issue tracker. When creating a new issue, a template will be shown containing instructions on how to collect the necessary information.

Additional debug information can be found in

~/cmus-debug.txt

if you configured cmus with maximum debug level (

./configure DEBUG=2

). In case of a crash the last lines may be helpful.

Git Repository

https://github.com/cmus/cmus

$ git clone https://github.com/cmus/cmus.git

Hacking

cmus uses the Linux kernel coding style. Use hard tabs. Tabs are always 8 characters wide. Keep the style consistent with rest of the code.

Bug fixes and implementations of new features should be suggested as a pull request directly on GitHub.