Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
@h1 NAME
cmus - C\* Music Player tutorial
@h1 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
@h1 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:
@pre
+---------------------------------------------------------------------+
| Artist / Album Track Library |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| |
| . 00:00 - 00:00 vol: 100 all from library | C |
| |
+---------------------------------------------------------------------+
@endpre
This is the view where your artists and albums will be displayed.
@h1 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:
@pre
+---------------------------------------------------------------------+
| Browser - /home/jasonwoof |
| ../ |
| Desktop/ |
| MySqueak/ |
| audio-projects/ |
| audio/ |
| bin/ |
| config/ |
| |
| . 00:00 - 00:00 vol: 100 all from library | C |
| |
+---------------------------------------------------------------------+
@endpre
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
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* 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.
@h1 Step 3: Playing Tracks From The Library
Press *2* to go to the simple library view. You should see something like
this:
@pre
+---------------------------------------------------------------------+
| Library ~/.config/cmus/lib.pl - 31 tracks sorted by artist album di |
| 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 |
| |
+---------------------------------------------------------------------+
@endpre
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.
@h1 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 affected 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.
@h1 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