pax_global_header00006660000000000000000000000064134240140640014510gustar00rootroot0000000000000052 comment=65d36d5ef4289bca26089f88e9a4aa6c2f915f37 cmus-2.8.0/000077500000000000000000000000001342401406400124665ustar00rootroot00000000000000cmus-2.8.0/.github/000077500000000000000000000000001342401406400140265ustar00rootroot00000000000000cmus-2.8.0/.github/ISSUE_TEMPLATE.md000066400000000000000000000003501342401406400165310ustar00rootroot00000000000000 --- 1) `uname -a`: ``` (paste output here) ``` 2) `cmus --version`: ``` (paste output here) ``` 3) `cmus --plugins`: ``` (paste output here) ``` cmus-2.8.0/.gitignore000066400000000000000000000003221342401406400144530ustar00rootroot00000000000000# normal ignores .* *~ *.[ao] *.lo *.so tags cscope.out !.gitignore !.travis.yml !.github # top-level ignores /*.spec /config /config.mk /cmus /cmus-remote # Cygwin stuff *.exe /cmus.base /cmus.def /cmus.exp cmus-2.8.0/.travis.yml000066400000000000000000000020671342401406400146040ustar00rootroot00000000000000dist: trusty language: c os: - linux - osx compiler: - clang - gcc addons: apt: sources: - ubuntu-toolchain-r-test packages: - g++-5 - libncursesw5-dev - libpulse-dev - libasound2-dev - libroar-dev - libao-dev - libjack-dev - libsamplerate0-dev - libcdio-dev - libcdio-cdda-dev - libcddb2-dev # - libopus-dev - libflac-dev - libvorbis-dev - libmpcdec-dev - libwavpack-dev - libmad0-dev - libavformat-dev - libavcodec-dev - libfaad-dev - libmp4v2-dev - libmodplug-dev - libmikmod2-dev homebrew: packages: - libmad - libcddb script: - if [ ${TRAVIS_OS_NAME} == "linux" ] && [ ${TRAVIS_COMPILER} == "gcc" ] ; then ./configure CC=/usr/bin/gcc-5 ; else ./configure ; fi - make cmus-2.8.0/AUTHORS000066400000000000000000000030441342401406400135370ustar00rootroot00000000000000Maintainers ----------- Gregory Petrosyan Jason Woofenden Original Author --------------- Timo Hirvonen NOTE: This list is not complete. Especially small changes/bug fixes may not be listed here. See the git repository for full list of contributors. Credits ------- original help window code and mad.charset option by Sergey Kuleshov artist/album mode idea and "display artist/album as a tree instead of two windows" idea from divxero play queue idea and other misc ideas from Martin Stubenschrott original RPM spec file by Eugene Vlasov Claes Nästen :seek command --volume option for cmus-remote Frank Terbeck dynamic keybindings patch alex Sun output plugin Tremor support for vorbis plugin NetBSD and OpenBSD port Various bug fixes Chun-Yu Shei mpc plugin gapless MP3 playback Johannes Weißl ao plugin Gregory Petrosyan PulseAudio output plugin Philipp 'ph3-der-loewe' Schafft RoarAudio output plugin Jason Woofenden Tutorial cmus-unofficial patch-commiter Niko Efthymiou Jack plugin Tuncer Ayaz Opus input plugin Boris Timofeev vtx plugin Yue Wang CoreAudio plugin Google Inc. cmus-2.8.0/COPYING000066400000000000000000000432541342401406400135310ustar00rootroot00000000000000 GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Lesser General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. , 1 April 1989 Ty Coon, President of Vice This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. cmus-2.8.0/Doc/000077500000000000000000000000001342401406400131735ustar00rootroot00000000000000cmus-2.8.0/Doc/.gitignore000066400000000000000000000000211342401406400151540ustar00rootroot00000000000000.* *.1 *.7 ttman cmus-2.8.0/Doc/cmus-remote.txt000066400000000000000000000052141342401406400161760ustar00rootroot00000000000000@title CMUS-REMOTE 1 05/11/2006 cmus @h1 NAME cmus-remote - control cmus @h1 SYNOPSIS cmus-remote [*OPTION*]... [`FILE`|`DIR`|`PLAYLIST`]...@br cmus-remote *-C* `COMMAND`...@br cmus-remote @h1 DESCRIPTION Add `FILE/DIR/PLAYLIST` to playlist, library (*-l*) or play queue (*-q*). If no arguments are given cmus-remote reads raw commands from stdin (one command per line). Raw commands are cmus' command mode commands. These same commands are used in configuration files and key bindings. *cmus*(1) contains full list of commands. For consistency also searching is supported: *-C /text*. If *-C* is given, all command line arguments are treated as raw commands. @h1 OPTIONS --server SOCKET Connect using socket *SOCKET* instead of `$XDG_RUNTIME_DIR/cmus-socket`. --help Display usage information and exit. --version Display version information and exit. -p, --play Start playing. -u, --pause Toggle pause. -U, --pause-playback Pause if currently playing. -s, --stop Stop playing. -n, --next Skip forward in playlist. -r, --prev Skip backward in playlist. -R, --repeat Toggle repeat. -S, --shuffle Toggle shuffle. -v, --volume VOL Change volume. See *vol* command in *cmus*(1). -k, --seek SEEK Seek. See *seek* command in *cmus*(1). -Q Get player status information. Same as *-C status*. Note that *status* is a special command only available to cmus-remote. -l, --library Modify library instead of playlist. -P, --playlist Modify playlist (default). -q, --queue Modify play queue instead of playlist. -c, --clear Clear playlist, library (*-l*) or play queue (*-q*). -C, --raw Treat arguments (instead of stdin) as raw commands. @h1 REMOTE COMMANDS Special commands only available to cmus-remote. status Print information about currently playing track. format_print Print arguments as `Format Strings`. Each argument starts a new line. @h1 EXAMPLES Add playlists/files/directories/URLs to library view (1 & 2): @pre $ cmus-remote -l music.m3u \\ http://live.urn1350.net:8080/urn_high.ogg @endpre Load (clear and add) playlist to playlist view (3): @pre $ cmus-remote -c music.m3u @endpre Three different ways to toggle repeat: @pre $ cmus-remote -R $ cmus-remote -C "toggle repeat" $ cmus-remote toggle repeat ^D @endpre Query settings or key bindings: @pre $ cmus-remote -C "set repeat?" setting: 'repeat=false' $ cmus-remote -C "showbind common a" bind common a win-add-l @endpre Dump the playlist to stdout: @pre $ cmus-remote -C "save -p -" [...] @endpre Search works too: @pre $ cmus-remote -C /beatles @endpre @h1 SEE ALSO *cmus*(1) @h1 AUTHOR Written by Timo Hirvonen cmus-2.8.0/Doc/cmus-tutorial.txt000066400000000000000000000254241342401406400165530ustar00rootroot00000000000000@title cmus-tutorial 7 14/02/2010 cmus @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 Playlists 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 are some keys to control playback: Press *c* to pause/unpause Press right/left to seek by 10 seconds Press *<*/*>* seek by one minute Press *z* to play the previous track and *b* to play the next track 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 four toggles. Only toggles which are "on" are shown, so now we only see the *C*. Here are the toggles: [C]ontinue If 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 If this is on, cmus will choose a random order to play all the tracks once. Press *s* to toggle this option. [F]ollow If this is on, cmus will select the currently playing track on track change. Press *f* 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 Playlists The playlists work like another set of libraries (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 mixes 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 playlists are 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 a playlist. The only visual feedback you'll get that anything happened is that the highlight will move down one row. Add a few more so you have something to work with. Now press *3* to go to the playlist. You should see something like this: @pre +---------------------------------------------------------------------+ | Playlist Track 11:32 | | * default | Flying Lizards . Money (Th... 02:31 | | | Jason Woofenden . VoR T... 2009 01:20 | | | Keali'i Reichel 06. Wanti... 1994 04:28 | | | Molly Lewis . Tom Cruis... 03:13 | | | | | | | | | | | | | . 00:00 - 00:00 vol: 100 all from library | C | | | +---------------------------------------------------------------------+ @endpre 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*. @h1 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. @h1 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. @h1 Step 8: Quit When you're done, type *:q* and press Enter to quit. This will save your settings, library, playlist and queue. @h1 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: `https://github.com/cmus/cmus/blob/master/Doc/cmus.txt` There are more commands and features not covered here like loading and saving playlists, controlling cmus remotely with `cmus-remote`, etc. cmus-2.8.0/Doc/cmus.txt000066400000000000000000001342251342401406400147120ustar00rootroot00000000000000@title CMUS 1 31/01/2010 cmus @h1 NAME cmus - C\* Music Player @h1 SYNOPSIS cmus [*options*] @h1 DESCRIPTION cmus is a small ncurses based music player. It supports various output methods by output-plugins. cmus has completely configurable keybindings and can be controlled from the outside via *cmus-remote*(1). @h1 OPTIONS --listen ADDR Listen to ADDR (UNIX socket) instead of `$CMUS_SOCKET` or `$XDG_RUNTIME_DIR/cmus-socket`. ADDR is either a UNIX socket or host[:port]. *WARNING*: Using host[:port] is insecure even with password! It might be useful though in LAN if you want multiple local users to able to control cmus. Never make cmus listen to the internet. NOTE: Don't use this option to run multiple instances as same user. That would corrupt the track metadata cache. --passwd PASSWD Set the password for TCP/IP connections. Must be set if you are listening from host[:port]. Used in conjunction with --listen. --plugins List available plugins and exit. --show-cursor Keep cursor always visible. This is useful for screen readers. --help Display usage information and exit. --version Display version information and exit. @h1 VIEWS There are 7 views in cmus. Press keys 1-7 to change active view. Library view (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 view (2) Displays same content as view 1, but as a simple list which is automatically sorted by user criteria. Playlist view (3) Displays editable playlists with optional sorting. Play Queue view (4) Displays queue of tracks which are played next. These tracks are played before anything else (i.e. the playlist or library). Browser (5) Directory browser. In this view, music can be added to either the library, marked playlist or queue from the filesystem. Filters view (6) Lists user defined filters. Settings view (7) Lists keybindings, unbound commands and options. Remove bindings with *D* or *del*, change bindings and variables with *enter* and toggle variables with *space*. @h1 COMMAND LINE Everything in cmus is implemented as commands which can be typed at command line or bound to a key. To enter command mode type *:*. To execute a command press *ENTER* or to cancel press *ESC* or *CTRL-C*. Use up/down arrows to browse command history. Use *TAB* to complete commands and parameters, you can tab complete almost anything. You don't need to type full command names if the command is unambiguous (no other commands starting with the same characters). Examples: @pre # add files, short for ':add ~/music' :a ~/music # change output plugin :set output_plugin=oss # start playing # you could just press 'x' which is the default # binding for this command :player-play # clear current view (library, playlist or play queue) :clear @endpre @h1 SEARCHING Search mode works like the command mode, to enter search mode press */* and then type the search words and press *ENTER*. Press *n* to search next or *N* to search previous match using the same search words. Type *?* to search backwards. In views 1-4 words are compared to artist, album and title tags. Type *//WORDS* or *??WORDS* to search only artists/albums in view 1 or titles in views 2-4. If the file doesn't have tags words are compared to filename without path. Searching works in views 5-7 too and its logic should be pretty obvious. @h1 PLAYLIST EDITING @h2 Selecting Tracks Editing commands affect the currently marked tracks or if there are no marked tracks the currently selected track (or selected artist/album in view 1). Mark selected track by pressing *SPACE*. Marked tracks appear with a gray background. You can only mark tracks in the list views (2-4). @h2 Copying Tracks Between Views You can copy marked or selected tracks from views 1-5. @li *a* copy tracks to the library (1-2) @li *y* copy tracks to the marked playlist (3) @li *e* append tracks to the play queue (4) @li *E* prepend tracks to the play queue (4) @h2 Moving Tracks In views 2-4 you can move tracks within the list. Note that moving is disabled if the view is auto-sorted (see *lib_sort* and *pl_sort* options). Pressing *p* moves marked tracks to the position immediately after the selected track. *P* moves them to the position immediately before the selected track. If there are no marked tracks then the selected track is moved down (*p*) or up (*P*). NOTE: Changing active filters reloads view 2 so it isn't a good idea to manually order tracks in the view. @h2 Removing Tracks Press *D* or *delete* to remove marked or selected tracks in the current view (1-4). The tracks will be removed immediately from the view without asking for confirmation. In the browser and filters views the same keys are used to remove a file or filter (will ask for confirmation). @h1 STATUS LINE Right hand side of the status line (second row from the bottom, black text on a grey background) consists of the following fields: @pre aaa_mode & play_sorted & play_library | continue follow repeat shuffle @endpre NOTE: *aaa_mode* and *play_sorted* will be displayed only if *play_library* is *true* because these are meaningless when playing the playlists (view 3). Pressing *m*, *o*, *M*, *C*, *r* and *s* keys should make it easier to understand what all those fields mean. See CONFIGURATION OPTIONS section for more information about these options. @h1 KEYBINDINGS Here's list of default keybindings. See *unbind* and *bind* commands in the COMMANDS section. @h2 Common Context @pre q quit -i ^C echo Type :quit to exit cmus. I echo {} b player-next c player-pause x player-play z player-prev v player-stop ^L refresh / search-start ? search-b-start n search-next N search-prev . seek +1m l, right seek +5 , seek -1m h, left seek -5 m toggle aaa_mode C toggle continue M toggle play_library o toggle play_sorted r toggle repeat ^R toggle repeat_current t toggle show_remaining_time s toggle shuffle f toggle follow F push filter L push live-filter u update-cache 1 view tree 2 view sorted 3 view playlist 4 view queue 5 view browser 6 view filters 7 view settings ! push shell ] vol +0 +1 [ vol +1 +0 +, = vol +10% } vol -0 -1 { vol -1 -0 - vol -10% enter, mlb_click_selected win-activate E win-add-Q a win-add-l y win-add-p e win-add-q G, end win-bottom down, j, mouse_scroll_down win-down p win-mv-after P win-mv-before tab win-next ^F, page_down win-page-down ^B, page_up win-page-up ^E win-scroll-down ^Y win-scroll-up D, delete win-remove i win-sel-cur space win-toggle g, home win-top k, up, mouse_scroll_up win-up @endpre @h2 Browser Context @pre space win-activate backspace browser-up i toggle show_hidden u win-update @endpre @h1 LIBRARY VIEW SORTING The library view (the tree-like one; not the sorted library view, for which the sorting is controlled by the user by setting lib_sort - see `CONFIGURATION OPTIONS`), is sorted automatically by cmus using the information found in the tagging information provided by the audio files. Generally, in the library view cmus uses three levels of sorting: the first level would be the artist name, the second one the album and finally the actual track. At first, cmus checks if the "filename" looks like an URL, if it does, the item is given the special artist and album name **. If it is a file, it is checked if the artist and album tags are set. If not, cmus assigns the special name ** for the unset tag. As the first level, cmus sorts alphanumerically by the value of the artist tag. ( and will be used as if they where normal names.) If a special sorting tag is available, it's value will be used instead. For album names, alphanumerical sorting is not the primary method, though. To decide, how the second level should be sorted, cmus looks at the date of the first track of each album. Sorting is done from young to old. Of course, if one artist happens to have more then one album from one year, alphanumerical sorting will be used after sorting by date. If the date header is not set, the album will be placed on top of the list (in fact, the internal integer value for unset album tags is -1). The method for third sorting level (the track) is very similar to album sorting. First two numerical values are checked (discnumber and tracknumber). If sorting is still ambiguous, sorting will be done alphanumerically by the value of the track's `filename` (not track name!). For simple albums, that is it. There is a special case, though. Albums, that feature various artists, also known as samplers or compilations. If a track belongs to a compilation is again decided by the existence and value of special tagging information. First, it is checked if cmus should use a special artist name (e.g.: `'Fatboy Slim'` for a DJ set). If so, that one will be used instead of the real artist name. If that special name tag is not set, cmus checks if another tag is set. If that is the case, the album will be given the special artist name **. Albums filed under ** are sorted alphanumerically by album name instead of by date. That way, you do not end up with compilation tracks scattered around your library view. The problem with compilation tagging is, that there is no generic tag or method, that can be regarded as a standard across all different formats, supported by cmus. For mp3, the special-name tag would be the id3v2 *TPE2* frame. The mark-as-compilation tag is the *TCMP* frame (which is a user defined id3v2.3 frame, used at least by amarok and apple's iTunes[tm]). For vorbis style tags (for example in ogg vorbis and flac files), the special-name tag is *ALBUMARTIST* and the mark-as-compilation tag is *COMPILATION*. Vorbis tags names are case insensitive. @h1 COMMANDS This section describes cmus' commands. You can bind a key to any of these commands, put these commands to configuration files and execute them in command mode. Also cmus-remote uses these commands in its protocol. Optional parameters are in brackets, obligatory parameters in angle brackets and default key bindings in parenthesis. add [-l] [-p] [-q] [-Q] Add file/dir/url/playlist to the specified view or the current view. @li -l add to library @li -p add to playlist @li -q add play queue @li -Q prepend to play queue URL is a Shoutcast stream (http://...) or a CDDA URL (cdda://...) (see *PLAYING AUDIO DISCS*). Supported playlist: plain, .m3u, .pls. bind [-f] Add a key binding. @li -f overwrite existing binding Use tab to expand contexts, keys and commands. Command is any command listed in this section. Valid key contexts common, library (1-2), playlist (3), queue (4), browser (5), filters (6) There's one context for each view. Common is a special context on which bound keys work in every view. You can override specific keys in common context for a view. For example *i* selects the current track in views 1-3 but in browser it is overridden to toggle showing of hidden files. browser-up (*backspace*) Change to parent directory in browser view (5). This command only makes sense to be bound to the *browser* key context although it's possible to use this even if browser view is not active. cd [directory] Changes the current working directory. Changes the directory displayed in browser view too. clear [-l] [-p] [-q] Remove all tracks from the specified view or the current view. @li -l clear library @li -p clear playlist @li -q clear play queue colorscheme Change color scheme. Color schemes are found in `/usr/share/cmus/` or `$XDG_CONFIG_HOME/cmus/` and have .theme filename extension. echo ... Display arguments on the command line. If the arguments contain *{}* it is replaced with file name of the first selected track. NOTE: unlike with *run* the *{}* is replaced with only the first selected filename. Default bindings: @pre common I echo {} common ^C echo Type :quit to exit cmus. @endpre factivate ... Select and activate the given user defined filters (displayed in the filters view). Filter names are separated by spaces. This command is mostly useful when bound to a key, to change active filters very quickly. If no arguments given then all filters are unactivated. If you prefix a filter name with "!" then the filter value is negated before activation. filter Use this command when you want to temporarily filter contents of the library views without having separately define (fset) and activate the filter. The filter is not saved. fset = Define (or replace existing) filter and add it to filters view (6). invert Invert the marking of tracks in playlist and queue views. See *mark* and *unmark*. live-filter Use this command when you want to temporarily filter contents of the library views without having separately define (fset) and activate the filter. The filter is not saved. load [-l] [-p] Load a playlist to the specified view or to the current view. @li -l load to library views @li -p load to playlist view lqueue [NUM] Queue NUM (default 1) random albums from the library. See also *tqueue*. mark Mark tracks in playlist and queue view by using a filter expression. pl-create Creates a new playlist. pl-export Exports the currently selected playlist. pl-import [filename] Imports a playlist into the playlist view. The argument can be omitted in the browser view. pl-rename Renames the selected playlist. player-next (*b*) Skip to the next track. player-pause (*c*) Toggle pause. player-pause-playback Pause if currently playing. player-play [filename] (*x*) Play the given track, or, if none is specified, [re]play the current track from the beginning. player-prev (*z*) Skip to the previous track. player-stop (*v*) Stop playback. prev-view Go to previously used view. left-view Go to view "to the left" of current one, e.g. view 4 -> view 3. right-view Go to view "to the right" of current one, e.g. view 3 -> view 4. push Enter command mode with the command line pre-set to text. Example: bind common w push filter artist= Text can contain spaces and even trailing spaces will be honored. This command can only be bound to a key but not used in the command line directly. pwd Prints the current working directory. quit [-i] (*q*, *:wq*) Exit cmus. @li -i ask before exiting raise-vte Raise the virtual terminal emulator window. Works only in X session. rand Randomizes (shuffles) the tracks in the library, playlist or queue view. refresh (*^L*) Redraw the terminal window. run Run command for the marked tracks OR the selected one if none marked. By default file names are appended to the command. If the command contains *{}* it is replaced with list of filenames. NOTE: In view 1 you can run a command for all files in the selected album or artist. save [-e] [-l] [-L] [-p] [-q] [file] (*:w*) Save the specified view's or the current view's contents to a playlist file. In extended mode (-e), also save metadata. @li -l save library views @li -L save filtered library views @li -p save playlist view @li -q save queue view If no filename given the old filename is used. "-" outputs to stdout (works only remotely). search-next (*n*) If a search pattern has been entered before, search forward for the next match in the current view. See *SEARCHING* above. search-prev (*N*) If a search pattern has been entered before, search backwards for the previous match in the current view. See *SEARCHING* above. seek [+-]([mh] | [HH:]MM:SS) Seek to absolute or relative position. Position can be given in seconds, minutes (m), hours (h) or HH:MM:SS format where HH: is optional. Seek 1 minute backward :seek -1m Seek 5 seconds forward :seek +5 Seek to absolute position 1h :seek 1h Seek 90 seconds forward :seek +1:30 Default bindings: @pre common , :seek -1m common . :seek +1m common l :seek +5 common h :seek -5 common right :seek +5 common left :seek -5 @endpre set