NAME¶
cmus - C* Music Player tutorial
CONTENTS¶
Step 1: Starting Cmus
Step 2: Adding Music
Step 3: Playing Tracks From The Library
Step 4: Managing The Queue
Step 5: The Playlist
Step 6: Find that track
Step 7: Customization
Step 8: Quit
Step 9: Further Reading
Step 1: Starting Cmus¶
When you first launch cmus (just type
cmus in a terminal and press Enter)
it will open to the album/artist view, which looks something like this:
+---------------------------------------------------------------------+
| Artist / Album Track Library |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| |
| . 00:00 - 00:00 vol: 100 all from library | C |
| |
+---------------------------------------------------------------------+
This is the view where your artists and albums will be displayed.
Step 2: Adding Music¶
Press
5 to switch to the file-browser view so we can add some music. You
should see something like this:
+---------------------------------------------------------------------+
| Browser - /home/jasonwoof |
| ../ |
| Desktop/ |
| MySqueak/ |
| audio-projects/ |
| audio/ |
| bin/ |
| config/ |
| |
| . 00:00 - 00:00 vol: 100 all from library | C |
| |
+---------------------------------------------------------------------+
Now, use the arrow keys, Enter and Backspace to navigate to where you have audio
files stored. To add music to your cmus library, use the arrow keys to hilight
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 on to your
library. This can take a while if you added a folder with a lot 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.)
Just to be on the safe side, lets save. Type
:save and press Enter.
Note: Cmus automatically saves your settings and library and everything when you
quit, so you probably won't use the save command much.
Step 3: Playing Tracks From The Library¶
Press
2 to go to the simple library view. You should see something like
this:
+---------------------------------------------------------------------+
| Library ~/.cmus/lib.pl - 31 tracks sorted by artist album discnumbe |
| Flying Lizards . Money (That's What I Want) 02:31 |
| Jason Woofenden . VoR Theme 2009 01:20 |
| Keali'i Reichel 06. Wanting Memories 1994 04:28 |
| Molly Lewis . Tom Cruise Crazy 03:13 |
| NonMemory . pista1 2009 03:18 |
| NonMemory 01. pista1 2009-04-21 04:13 |
| Ray Charles 06. Halleluja I Love Her So 02:33 |
| |
| . 00:00 - 2:16:25 vol: 100 all from library | C |
| |
+---------------------------------------------------------------------+
Use the up and down arrow keys 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 to seek by 10 seconds Press
</
> seek by one minute
cmus has some great options to control what plays next (if anything) when the
track ends. The state of these settings are shown in the bottom right corner.
The first of these shows what collection of tracks (currently "all from
library") we are playing. Press
m to cycle through the different
options for this setting. To the right of that (past the "|") cmus
shows the state of three toggles. Only toggles which are "on" are
shown, so now we only see the
C. Here are the toggles:
[C]ontinue
When this is off, cmus will always stop at the end of the track. You can toggle
this setting by pressing
shift-C.
[R]epeat
If this is on (and continue is on), when cmus reaches the end of the group of
tracks you're playing (selected with the
m key) it will start again
from the beginning. Press
r to toggle this setting.
[S]huffle
When this is on, cmus will choose a random order to play all the tracks once.
Press
s to toggle this option.
Step 4: Managing The Queue¶
Lets say you're listening to a song, and you want to select which song will play
next, without interrupting the currently playing song. No problem! Just go to
the song you want to hear next (in any of the views) and press
e. The
queue is FIFO, meaning if you queue up another track, it will play after the
one you already had queued up.
Note: The queue is not effected by the "shuffle" option described
above.
Press
4 to view/edit the queue. This view works and looks a lot like the
simple library view. The main difference is that you can change the order of
the tracks with the
p and
P keys. You can press
shift-D
to remove a track from the queue.
When cmus is ready to play another track (it's reached the end of a track and
the "continue" setting is on) it will remove the top entry from the
queue and start playing it.
Step 5: The Playlist¶
The playlist works like another library (like view
2) except that (like
the queue) you manually set the order of the tracks. This can be quite useful
if you want to create a mix of specific tracks or if you want to listen to an
audio book without having the chapters play when you're playing "all from
library".
The playlist is on view
3. But before we go there, lets add some tracks.
Press
2 to go to the simple library view, go to a track you want and
press
y to add it to the playlist. The only visual feedback you'll get
that anything happened is that the hilight will move down one row. Add a few
more so you have something to work with.
Now press
3 to go to the playlist.
Just like the queue, you can use the
p,
P and
D keys to
move and delete tracks from the playlist.
Note: Changing the view (e.g. by pressing
3) does not affect what cmus
will play next. To put cmus into "play from the playlist" mode,
press Enter on one of the tracks in the playlist. To switch modes without
interrupting the currently-playing song, you can press
shift-M.
Step 6: Find that track¶
This step shows various ways you can find track(s) you're looking for.
Search: Press
2 to be sure you're on the simple library view, then press
/ to start a search. Type a word or two from the track you're looking
for. cmus will search for tracks that have all those words in them. Press
enter to get the keyboard out of the search command, and
n to find the
next match.
Tree View: Press
1 to select the tree view. Scroll to the artist, press
space to show their albums, scroll to the album you want, then press
tab so the keyboard controls the right column. Press tab again to get back to
the left column.
Filters: See the reference manual (see Further Reading below) for a detailed
description on how to quickly (and temporarily) hide most of your music.
Step 7: Customization¶
Cmus has some very cool settings you can tweak, like changing the way tracks are
displayed (e.g. to display disk numbers), enabling replaygain support or
changing the keybindings.
Press
7 for a quick overview of the current keybindings and settings.
To change a setting or keybind, just select it (up/down keys) and press 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.
Please see the reference manual (see Further Reading below) for a detailed
description of all the commands and settings available.
Step 8: Quit¶
When you're done, type
:q and press Enter to quit. This will save your
settings, library, playlist and queue.
Step 9: Further Reading¶
Cmus comes with a great reference manual. Now that you've got the basics down it
should be intelligible. Try
man cmus in a terminal. If that's not
installed, try opening up
cmus.txt from the
Doc directory, or
read the latest version online:
http://gitorious.org/cmus/cmus/blobs/master/Doc/cmus.txt
There are more commands and features not covered hear like loading and saving
playlists, controlling cmus remotely with
cmus-remote, etc.