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.
Alternatively, there is also a development version available in the AUR called AUR.
Cmus comes with a great reference manual.
$ man cmus $ man cmus-tutorial $ man cmus-remote
To start cmus, type:
When you first launch cmus it will open to the album/artist tab.
Press Template:Keypress to switch to the file-browser tab so we can add some music. Now, use the arrow keys (Template:Keypress, Template:Keypress), Template:Keypress and Template:Keypress to navigate to where you have audio files stored. Alternatively, you may use the vim bindings (Template:Keypress, Template:Keypress) 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 Template:Keypress. When you press Template:Keypress 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 Template:Keypress 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.
Press Template:Keypress to go to the simple library view. Use the (Template:Keypress and Template:Keypress arrow keys (or Template:Keypress, Template:Keypress) to select a track you'd like to hear, and press Template:Keypress to play it. Here's some keys to control play:
- Press Template:Keypress to pause/unpause
- Press Template:Keypress/Template:Keypress (or Template:Keypress, Template:Keypress) arrow keys to seek by 10 seconds
- Press Template:Keypress/Template:Keypress seek by one minute
Press Template:Keypress for a quick overview of the current keybindings and settings. To change a setting or keybind, just select it (Template:Keypress/Template:Keypress keys) and press Template:Keypress. 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.
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:
#!/bin/sh # # Author: Dennis Hodapp # Filename: cplay # Requires: cmus # # Tests if cmus is running and starts it if it isn't. # Else it toggles play/pause. # This command will break if you rename it to # something containing "cmus". TERMINAL=/usr/bin/xterm SHELL=/bin/sh if ! ps aux | grep -w "cmus$" | grep -v grep > /dev/null ; then $TERMINAL -e $SHELL -c cmus & > /dev/null else cmus-remote -u fi
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:
<keyboard> <keybind key="XF86AudioPlay"> <action name="Execute"> <command>cplay</command> </action> </keybind> <keybind key="XF86AudioNext"> <action name="Execute"> <command>cmus-remote -n</command> </action> </keybind> <keybind key="XF86AudioPrev"> <action name="Execute"> <command>cmus-remote -r</command> </action> </keybind> </keyboard>
Now when you use the
XF86AudioPlay key on your keyboard, cmus will open up. If it's opened already it will then start playing. Using the XF86AudioNext and XF86AudioPrev keys will change tracks.
Library tab (1)
Display all tracks in so-called library. Tracks are sorted artist/album tree. Artist sorting is done alphabetically. Albums are sorted by year.
Sorted library tab (2)
Displays same content as view, but as a simple list which is automatically sorted by user criteria.
Playlist tab (3)
Displays editable playlist with optional sorting.
Play Queue tab (4)
Displays queue of tracks which are played next. These tracks are played before anything else (i.e. the playlist or library).
Directory browser. In this tab, music can be added to either the library, playlist or queue from the filesystem.
Filters tab (6)
Lists user defined filters.
Settings tab (7)
Lists keybindings, unbound commands and options. Remove bindings with Template:Keypress or Template:Keypress, change bindings and variables with Template:Keypress and toggle variables with Template:Keypress.