Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cmus/cmus

Small, fast and powerful console music player for Unix-like operating systems.
https://github.com/cmus/cmus

Last synced: about 2 months ago
JSON representation

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

Host: GitHub
URL: https://github.com/cmus/cmus
Owner: cmus
License: gpl-2.0
Created: 2012-12-29T10:05:50.000Z (over 11 years ago)
Default Branch: master
Last Pushed: 2024-06-03T19:35:19.000Z (4 months ago)
Last Synced: 2024-07-02T21:43:32.944Z (3 months ago)
Language: C
Homepage: https://cmus.github.io/
Size: 5.8 MB
Stars: 5,410
Watchers: 105
Forks: 467
Open Issues: 265
Metadata Files:
- Readme: README.md
- Changelog: history.c
- License: COPYING
- Authors: AUTHORS

Awesome Lists containing this project

awesome-cli-apps - cmus - Small, fast and powerful console music player. (Entertainment / Music)
fucking-Awesome-Linux-Software - ![Open-Source Software - A small, fast and powerful console music player for Unix-like operating systems. (Applications / Audio)
vim-keybindings-everywhere-the-ultimate-list - cmus - A console music player with vim-like [keybindings](https://man.archlinux.org/man/cmus.1.en#KEYBINDINGS). (Music Players)
awesome-starred - cmus - Small, fast and powerful console music player for Unix-like operating systems. (C)
jimsghstars - cmus/cmus - Small, fast and powerful console music player for Unix-like operating systems. (C)
awesome-linux-customization - **cmus** - A small ncurses based music player. (Music Player)
fucking-awesome-cli-apps - cmus - Small, fast and powerful console music player. (Entertainment / Music)
awesome-linux-ricing - cmus
Awesome-Linux-Software - ![Open-Source Software - A small, fast and powerful console music player for Unix-like operating systems. (Applications / Audio)

README

cmus — C\* Music Player
=======================

https://cmus.github.io/

[![Build Status](https://travis-ci.org/cmus/cmus.svg?branch=master)](https://travis-ci.org/cmus/cmus)

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](https://github.com/cmus/cmus/issues)
page for any problems, suggestions, or bug reports.

IRC Channel
------------

Feel free to join IRC channel #cmus on Libera.chat and share you experience, problems and issues.
Note: This is an unofficial channel and all people hanging around there are for the love of cmus.

Reporting Bugs
--------------

Bugs should be reported using the GitHub [issue tracker](https://github.com/cmus/cmus/issues).
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](https://www.kernel.org/doc/html/latest/process/coding-style.html).
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](https://github.com/cmus/cmus/pulls) directly on GitHub.