cmus — C* Music Player

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 cmus-devel@lists.sourceforge.net visit http://lists.sourceforge.net/lists/listinfo/cmus-devel

The list is open but moderated (you can post to the list without subscribing but it's not recommended because I have to accept each email from non-subscribed users). Traffic of the list is extremely low. Please use the issues page for any problems, suggestions, or bug reports.

Reporting Bugs

After a crash send bug report with last lines of ~/cmus-debug.txt to cmus-devel@lists.sourceforge.net. The file exists only if you configured cmus with maximum debug level (./configure DEBUG=2).

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.

Use git format-patch to generate patches from your commits. Alternatively you can use diff -up if you don't want to use git.

Name		Name	Last commit message	Last commit date
Latest commit History 1,705 Commits
Doc		Doc
contrib		contrib
data		data
scripts		scripts
.gitignore		.gitignore
.travis.yml		.travis.yml
AUTHORS		AUTHORS
COPYING		COPYING
Makefile		Makefile
README.md		README.md
aac.c		aac.c
aac.h		aac.h
alsa.c		alsa.c
ao.c		ao.c
ape.c		ape.c
ape.h		ape.h
arts.c		arts.c
browser.c		browser.c
browser.h		browser.h
buffer.c		buffer.c
buffer.h		buffer.h
cache.c		cache.c
cache.h		cache.h
cdio.c		cdio.c
channelmap.c		channelmap.c
channelmap.h		channelmap.h
cmdline.c		cmdline.c
cmdline.h		cmdline.h
cmus-status-display		cmus-status-display
cmus.c		cmus.c
cmus.h		cmus.h
command_mode.c		command_mode.c
command_mode.h		command_mode.h
comment.c		comment.c
comment.h		comment.h
compiler.h		compiler.h
configure		configure
convert.c		convert.c
convert.h		convert.h
cue.c		cue.c
cue_utils.c		cue_utils.c
cue_utils.h		cue_utils.h
debug.c		debug.c
debug.h		debug.h
discid.c		discid.c
discid.h		discid.h
editable.c		editable.c
editable.h		editable.h
expr.c		expr.c
expr.h		expr.h
ffmpeg.c		ffmpeg.c
file.c		file.c
file.h		file.h
filters.c		filters.c
filters.h		filters.h
flac.c		flac.c
format_print.c		format_print.c
format_print.h		format_print.h
gbuf.c		gbuf.c
gbuf.h		gbuf.h
glob.c		glob.c
glob.h		glob.h
help.c		help.c
help.h		help.h
history.c		history.c
history.h		history.h
http.c		http.c
http.h		http.h
id3.c		id3.c
id3.h		id3.h
input.c		input.c
input.h		input.h
ip.h		ip.h
iter.h		iter.h
jack.c		jack.c
job.c		job.c
job.h		job.h
keys.c		keys.c
keys.h		keys.h
keyval.c		keyval.c
keyval.h		keyval.h
lib.c		lib.c
lib.h		lib.h
list.h		list.h
load_dir.c		load_dir.c
load_dir.h		load_dir.h
locking.c		locking.c
locking.h		locking.h
mad.c		mad.c
main.c		main.c
mergesort.c		mergesort.c
mergesort.h		mergesort.h
mikmod.c		mikmod.c
misc.c		misc.c
misc.h		misc.h
mixer.h		mixer.h
mixer_alsa.c		mixer_alsa.c
mixer_oss.c		mixer_oss.c
mixer_sun.c		mixer_sun.c
modplug.c		modplug.c

License

losingkeys/cmus

Folders and files

Latest commit

History