Provided by: cmus_2.4.2-1_i386 bug

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.