Differences

This shows you the differences between two versions of the page.

--- terminal:cmus [2022/03/14 21:49]
nanodano created
+++ terminal:cmus [2022/03/14 22:48] (current)
nanodano
@@ Line 10: / Line 10: @@
 </code>
-===== Documentation =====
+===== Getting help =====
-There is a man page with lots of information. Inside the app, you can press ``7`` and view the keybinds.
+There is a man page with lots of information. Man page 7 is a basic tutorial.
 <code bash>
-# Read cmus documentation
+# Read general cmus documentation
 man cmus
+# Read cmus tutorial
+man 7 cmus
 </code>
+Or, when inside the app, press ''7'' to view the help tab. 1-6 are the other tabs.
+<code>
+</code>
-It is like vim. There is the mode where you are browsing and tabbing through the music. You can use the arrow keys or vim-like ``j`` and ``k`` to move around. Press ``TAB`` to switch from the artist/album list to the track list. Press enter to start a song.
-Type ``:`` to begin entering commands. There is also tab completion.
-To search, type ``/`` and enter the phrase. Press ``n`` to find next occurrence.
-===== Common tasks =====
+===== Manage library =====
+The library lives in ''~/.config/cmus/lib.pl'' and is simply a newline separated list of file paths. It will build a cache with song info, but will not move any music files. Your playlists, command history and search history are also stored in this directory.
 <code>
-# Add all music from library
+# Add music from disk
 :add ~/Music
-# Press x to play or run:
+</code>
+Alternatively, press ''5'' to view the file browser. Find the file or directory you want to add, and press ''a'' to add it.
+To remove a song from the library, press ''D''.
+To clear the library, use '':clear''
+<code>
+# Remove all music from list
+:clear
+</code>
+===== Save settings =====
+If you ever want to save settings, run '':save''. This will happen when existing automatically.
+<code>
+:save
+</code>
+===== Browse library =====
+Press ''1'' or ''2'' to browse the library. View 1 is the sorted tree view. View 2 is the flat list of all songs.
+===== Search =====
+To search, type ''/'' and enter the phrase. Press ''n'' to find next occurrence and ''SHIFT-n'' to go backwards.
+===== Play songs =====
+You can press ''x'' to start the player, or use the commands like '':player-play''. Remember there is auto-complete, and hotkey ''7'' available if you need help.
+<code>
+# To play, press `x`, or run commands:
 :player-play
 :player-pause
 :player-stop
 </code>
+If you find a song you want to play in the browser, just press ENTER on the song to play it.
+===== Queue a song =====
+Press ''e'' to queue a song. It will get played next even if shuffle is on. It will get popped off the queue once it starts.
+Press ''4'' to view the queue. Use ''p'', ''P'' to sort and ''D'' to remove songs.
+===== Playlists =====
+Create a playlist with '':pl-create My Favorites''. Playlists are stored in ''.config/cmus/playlists'' and are simply newline separated lists of file paths.
+Press ''3'' to view your playlists. Press ''space'' to select a playlist it. An asterisk will appear next to it, designating it the active playlist.
+Press ''y'' to add a song to the playlist from view ''1'' or ''2''.
+Use ''p'', ''P'' to sort and ''D'' to remove songs.
+===== Shuffle, Repeat, Continue =====
+In the bottom right, there are four flags: ''CRFS''. They stand for:
+  * Continue - ''SHIFT-c'' to toggle. Continues to next song after finishing
+  * Repeat - ''r'' to toggle. Repeats playlist when complete
+  * Shuffle - ''s'' to toggle. Randomizes next song
+  * Follow - ''f'' to toggle. Jump your cursor to the next song when it plays, versus leaving you where you are.

DevDungeon Wiki

User Tools

Site Tools

Differences

Page Tools