+3
日增长
+13
周增长
+30
月增长
6,296
stars
522
forks
103
watchers
480
prs
974
issues
12
releases
README
cmus — C\ Music Player
https://cmus.github.io/
Copyright © 2004-2008 Timo Hirvonen
Copyright © 2008-2017 Various Authors
Configuration
$ ./configure
By default, features are auto-detected. To list all configuration options, run
./configure --help. Some common autoconf-style options like --prefix are
also available.
After running configure you can see from the generated config.mk file
what features have been configured in (see the CONFIG_ options).
The packages containing dependencies on common distributions are listed below. All dependencies other than pkg-config and ncurses, iconv, and elogind/systemd are for optional input/output plugins. It is assumed that libc headers, a C compiler, git, and GNU Make are available.
| Distro | Dependencies |
| :-- | :-- |
| Debian/Ubuntu | apt install pkg-config libncursesw5-dev libfaad-dev libao-dev libasound2-dev libcddb2-dev libcdio-cdda-dev libdiscid-dev libavformat-dev libavcodec-dev libswresample-dev libflac-dev libjack-dev libmad0-dev libmodplug-dev libmpcdec-dev libsystemd-dev libopusfile-dev libpulse-dev libsamplerate0-dev libsndio-dev libvorbis-dev libwavpack-dev |
| Fedora/RHEL | dnf install 'pkgconfig(ncursesw)' 'pkgconfig(alsa)' 'pkgconfig(ao)' 'pkgconfig(libcddb)' 'pkgconfig(libcdio_cdda)' 'pkgconfig(libdiscid)' 'pkgconfig(libavformat)' 'pkgconfig(libavcodec)' 'pkgconfig(libswresample)' 'pkgconfig(flac)' 'pkgconfig(jack)' 'pkgconfig(mad)' 'pkgconfig(libmodplug)' libmpcdec-devel 'pkgconfig(libsystemd)' 'pkgconfig(opusfile)' 'pkgconfig(libpulse)' 'pkgconfig(samplerate)' 'pkgconfig(vorbisfile)' 'pkgconfig(wavpack)' |
| + RPMFusion | dnf install faad2-devel libmp4v2-devel |
| Arch Linux | pacman -S pkg-config ncurses libiconv faad2 alsa-lib libao libcddb libcdio-paranoia libdiscid ffmpeg flac jack libmad libmodplug libmp4v2 libmpcdec systemd opusfile libpulse libsamplerate libvorbis wavpack |
| Alpine | apk add pkgconf ncurses-dev gnu-libiconv-dev alsa-lib-dev libao-dev libcddb-dev ffmpeg-dev flac-dev jack-dev libmad-dev libmodplug-dev elogind-dev opus-dev opusfile-dev pulseaudio-dev libsamplerate-dev libvorbis-dev wavpack-dev |
| Termux | apt install libandroid-support ncurses libiconv ffmpeg libmad libmodplug opusfile pulseaudio libflac libvorbis libwavpack |
| Homebrew | brew install pkg-config ncurses faad2 libao libcddb libcdio libdiscid ffmpeg flac jack mad libmodplug mp4v2 musepack opusfile libsamplerate libvorbis wavpack |
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
IRC Channel
Feel free to join IRC channel cmus on Libera.chat and share you experience,
problems and issues. Note: This is an unoffiTop issues
#285Filtering operations are incredibly slow (800MHz Duron, ~100000 tracks)24 comments · 2015-05-21#233Feature request: Auto-update library23 comments · 2015-01-09#255Cmus 'skips' some m4a files19 comments · 2015-02-23#342fast forward restarts some tracks18 comments · 2015-10-14#912coreaudio doesn't handle files with high bitrate15 comments · 2019-06-18#207HTTPS streaming support15 comments · 2014-11-01#997Rendering issues with emojis or "zalgo" text14 comments · 2020-10-07#222Support for Popularimeter ID3 tag14 comments · 2014-12-04
Discussions
#1514Is there a way to jump to the currently playing track?1 comments · 2026-09-01#1507Reorder tracks in queue1 comments · 2026-07-19#1501Call `status_display_program` with current playback position1 comments · 2026-04-24#1500Modern synced lyrics viewer for cmus (cmus-lyric)0 comments · 2026-04-09#1487How to get back to "library" instead of "sorted library"1 comments · 2026-01-17#1483auto adding music using txt file through yt-dlp0 comments · 2025-12-26#1475"Delayed Reboot" issue with cmus?0 comments · 2025-12-09#1474delayed reboot caused by cmus??1 comments · 2025-12-09
Latest release
cmus 2.13.0 «2k26» v2.13.0 2026-10-28I am happy to announce a new cmus release, two years after the last one, containing many bugfixes by the members of the community, most notably @ihy123, and a few new features. What's Changed Set the minimum requested AAudio buffer capacity by @pgaskin in https://github.com/cmus/cmus/pull/1386 Check for libavutil pkg-config by @pgaskin in https://github.com/cmus/cmus/pull/1388 [CI] Update dependency list to fix ubuntu build setup by @gavtroy in https://github.com/cmus/cmus/pull/1414 Add sort by duration by @hunkyburrito in https://github.com/cmus/cmus/pull/1440 Respect scroll_off