[http://cmus.sourceforge.net/ cmus] ''(C* MUsic Player)'' is a small, fast and powerful console audio player which supports most major audio formats. Various features include gapless playback, ReplayGain support, MP3 and Ogg streaming, live filtering, instant startup, customizable key-bindings, and vi-style default key-bindings.

[http://cmus.sourceforge.net/ cmus] ''(C* MUsic Player)'' is a small, fast and powerful console audio player which supports most major audio formats. Various features include gapless playback, ReplayGain support, MP3 and Ogg streaming, live filtering, instant startup, customizable key-bindings, and vi-style default key-bindings.

=Installation=

=Installation=

−

[[pacman|Install]] {{Pkg|cmus}}, available in the [[Official Repositories]].

+

[[pacman|Install]] {{Pkg|cmus}}, available in the [[Official repositories]].

Alternatively, there is also a development version available in the [[AUR]] called {{AUR|cmus-git}}.

Alternatively, there is also a development version available in the [[AUR]] called {{AUR|cmus-git}}.

+

+

= Configuration =

+

To configure cmus start it and switch to the configuration tab by pressing {{ic|7}}. Now you can see a list of default keybindings. Select a field in the list with the arrow keys and press{{ic|Enter}} to edit the values. You can also remove bindings with {{ic|D}} or {{ic|del}}. To edit unbound commands and option variables scroll down in the list to the relevant section. Variables can also be toggled instead of edited with {{ic|space}}. Cmus allows changing the color of nearly every interface element. You can prefix colors with "light" to make them appear brighter and set attributes for some text elements.

+

+

== Using cmus with alsa ==

+

When using cmus with [[Advanced Linux Sound Architecture]] the default configuration does not allow playing music. To fix it change three variables, set {{ic|dsp.alsa.device}} to {{ic|default}} , set {{ic|mixer.alsa.channel}} to {{ic|Master}} and set {{ic|mixer.alsa.device}} to {{ic| default}}.

=Usage=

=Usage=

Line 22:

Line 28:

== Adding Music ==

== Adding Music ==

−

Press {{Keypress|5}} to switch to the file-browser tab so we can add some music.

+

Press {{ic|5}} to switch to the file-browser tab so we can add some music.

−

Now, use the arrow keys ({{Keypress|up}}, {{Keypress|down}}), {{Keypress|Enter}} and {{Keypress|Backspace}} to navigate to where you have audio files stored. Alternatively, you may use the vim bindings ({{Keypress|k}}, {{Keypress|j}}) to navigate up and down through your music.

+

Now, use the arrow keys ({{ic|up}}, {{ic|down}}), {{ic|Enter}} and {{ic|Backspace}} to navigate to where you have audio files stored. Alternatively, you may use the vim bindings ({{ic|k}}, {{ic|j}}) to navigate up and down through your music.

−

To add music to your cmus library, use the arrow keys to highlight a file or folder, and press {{Keypress|a}}. When you press {{Keypress|a}} cmus will move you to the next line down (so that it is easy to add a bunch of files/folders in a row) and start adding the file/folder you pressed {{Keypress|a}} in to your library. This may take a bit if you added a folder with a lot of music in it. As files are added, you will see the second time in the bottom right go up. This is the total duration of all the music in the cmus library.

+

To add music to your cmus library, use the arrow keys to highlight a file or folder, and press {{ic|a}}. When you press {{ic|a}} cmus will move you to the next line down (so that it is easy to add a bunch of files/folders in a row) and start adding the file/folder you pressed {{ic|a}} in to your library. This may take a bit if you added a folder with a lot of music in it. As files are added, you will see the second time in the bottom right go up. This is the total duration of all the music in the cmus library.

{{Note|cmus does not move, duplicate or change your files. It just remembers where they are and caches the metadata (duration, artist, etc.)}}

{{Note|cmus does not move, duplicate or change your files. It just remembers where they are and caches the metadata (duration, artist, etc.)}}

Press {{Keypress|1}} to go to the simple library view. Use the ({{Keypress|up}} and {{Keypress|down}} arrow keys (or {{Keypress|k}}, {{Keypress|j}}) to select a track you'd like to hear, and press {{Keypress|Enter}} to play it. Here's some keys to control play:

+

Press {{ic|1}} to go to the simple library view. Use the ({{ic|up}} and {{ic|down}} arrow keys (or {{ic|k}}, {{ic|j}}) to select a track you'd like to hear, and press {{ic|Enter}} to play it. Here's some keys to control play:

Press {{Keypress|7}} for a quick overview of the current keybindings and settings. To change a setting or keybind, just select it ({{Keypress|up}}/{{Keypress|down}} keys) and press {{Keypress|Enter}}. This will put the command for the current setting in the command now (bottom left of your screen), which you can edit to put in a new value/key.

+

See the configuration section on how to change keybindings.

== Remote Control ==

== Remote Control ==

Line 91:

Line 97:

=Tabs=

=Tabs=

−

There are 7 tabs in cmus. Press keys {{Keypress|1}}-{{Keypress|7}} to change active tab.

+

There are 7 tabs in cmus. Press keys {{ic|1}}-{{ic|7}} to change active tab.

== Library tab (1) ==

== Library tab (1) ==

Line 112:

Line 118:

== Settings tab (7) ==

== Settings tab (7) ==

−

Lists keybindings, unbound commands and options. Remove bindings with {{Keypress|D}} or {{Keypress|del}}, change bindings and variables with {{Keypress|Enter}} and toggle variables with {{Keypress|space}}.

+

Change settings. See configuration for further information.

=Links=

=Links=

−

# [http://gitorious.org/cmus Git Repository]

+

# [https://github.com/cmus/cmus Git Repository]

# [http://cmus.sourceforge.net/ Website]

# [http://cmus.sourceforge.net/ Website]

Revision as of 11:56, 24 February 2014

cmus(C* MUsic Player) is a small, fast and powerful console audio player which supports most major audio formats. Various features include gapless playback, ReplayGain support, MP3 and Ogg streaming, live filtering, instant startup, customizable key-bindings, and vi-style default key-bindings.

Installation

Alternatively, there is also a development version available in the AUR called cmus-gitAUR.

Configuration

To configure cmus start it and switch to the configuration tab by pressing 7. Now you can see a list of default keybindings. Select a field in the list with the arrow keys and pressEnter to edit the values. You can also remove bindings with D or del. To edit unbound commands and option variables scroll down in the list to the relevant section. Variables can also be toggled instead of edited with space. Cmus allows changing the color of nearly every interface element. You can prefix colors with "light" to make them appear brighter and set attributes for some text elements.

Using cmus with alsa

When using cmus with Advanced Linux Sound Architecture the default configuration does not allow playing music. To fix it change three variables, set dsp.alsa.device to default , set mixer.alsa.channel to Master and set mixer.alsa.device to default.

Usage

Cmus comes with a great reference manual.

$ man cmus
$ man cmus-tutorial
$ man cmus-remote

Starting Cmus

To start cmus, type:

$ cmus

When you first launch cmus it will open to the album/artist tab.

Adding Music

Press 5 to switch to the file-browser tab so we can add some music.
Now, use the arrow keys (up, down), Enter and Backspace to navigate to where you have audio files stored. Alternatively, you may use the vim bindings (k, j) to navigate up and down through your music.

To add music to your cmus library, use the arrow keys to highlight a file or folder, and press a. When you press a cmus will move you to the next line down (so that it is easy to add a bunch of files/folders in a row) and start adding the file/folder you pressed a in to your library. This may take a bit if you added a folder with a lot of music in it. As files are added, you will see the second time in the bottom right go up. This is the total duration of all the music in the cmus library.

Note: cmus does not move, duplicate or change your files. It just remembers where they are and caches the metadata (duration, artist, etc.)

Playing Tracks

Press 1 to go to the simple library view. Use the (up and down arrow keys (or k, j) to select a track you'd like to hear, and press Enter to play it. Here's some keys to control play:

Press c to pause/unpause

Press right/left (or h, l) arrow keys to seek by 10 seconds

Press </> seek by one minute

Keybindings

See the configuration section on how to change keybindings.

Remote Control

Cmus can be controlled externally through a unix-socket with cmus-remote. This makes it easy to control playback through an external application or key-binding.

One such usage of this feature is to control playback in Cmus with the XF86 keyboard events. The following script when run will start Cmus in an xterm terminal if it isn't running, otherwise it will will toggle play/pause:

To use the previous script in Openbox, copy the code above into a file ~/bin/cplay. Make the file executable using chmod +x ~/bin/cplay. Next edit ~/.config/openbox/rc.xml and change the following key-bindings to look like this: