From ed579cafbd5b1fc7c8b7cb1c68fe8ac16a520202 Mon Sep 17 00:00:00 2001 From: Alessio Treglia Date: Thu, 15 Nov 2012 00:28:20 +0000 Subject: [PATCH 1/1] Import cmus_2.5.0.orig.tar.bz2 [dgit import orig cmus_2.5.0.orig.tar.bz2] --- .gitignore | 21 + AUTHORS | 55 + COPYING | 339 ++++ Doc/.gitignore | 4 + Doc/cmus-remote.txt | 137 ++ Doc/cmus-tutorial.txt | 242 +++ Doc/cmus.txt | 1379 ++++++++++++++++ Doc/ttman.c | 882 ++++++++++ Makefile | 267 +++ README | 112 ++ aac.c | 539 ++++++ aac.h | 41 + alsa.c | 386 +++++ ao.c | 278 ++++ ape.c | 260 +++ ape.h | 62 + arts.c | 134 ++ browser.c | 490 ++++++ browser.h | 52 + buffer.c | 209 +++ buffer.h | 36 + cache.c | 518 ++++++ cache.h | 37 + cdio.c | 538 ++++++ channelmap.c | 63 + channelmap.h | 94 ++ cmdline.c | 225 +++ cmdline.h | 66 + cmus-status-display | 50 + cmus.c | 390 +++++ cmus.h | 95 ++ command_mode.c | 2989 ++++++++++++++++++++++++++++++++++ command_mode.h | 67 + comment.c | 256 +++ comment.h | 37 + compiler.h | 85 + configure | 540 ++++++ contrib/README | 10 + contrib/_cmus | 50 + contrib/cmus-updategaim.py | 20 + contrib/cmus-updatepidgin.py | 25 + convert.c | 129 ++ convert.h | 33 + cue.c | 405 +++++ cue_utils.c | 113 ++ cue_utils.h | 42 + data/cyan.theme | 23 + data/default.theme | 23 + data/gray-88.theme | 24 + data/green-mono-88.theme | 62 + data/green.theme | 65 + data/rc | 78 + data/xterm-white.theme | 24 + data/zenburn.theme | 52 + debug.c | 107 ++ debug.h | 49 + discid.c | 152 ++ discid.h | 28 + editable.c | 403 +++++ editable.h | 76 + expr.c | 980 +++++++++++ expr.h | 77 + ffmpeg.c | 569 +++++++ file.c | 185 +++ file.h | 45 + filters.c | 469 ++++++ filters.h | 92 ++ flac.c | 591 +++++++ format_print.c | 541 ++++++ format_print.h | 57 + gbuf.c | 119 ++ gbuf.h | 60 + glob.c | 245 +++ glob.h | 28 + help.c | 326 ++++ help.h | 66 + history.c | 205 +++ history.h | 40 + http.c | 516 ++++++ http.h | 70 + id3.c | 1283 +++++++++++++++ id3.h | 76 + input.c | 955 +++++++++++ input.h | 86 + ip.h | 109 ++ iter.h | 172 ++ job.c | 401 +++++ job.h | 49 + keys.c | 657 ++++++++ keys.h | 61 + keyval.c | 126 ++ keyval.h | 44 + lib.c | 696 ++++++++ lib.h | 174 ++ list.h | 324 ++++ load_dir.c | 107 ++ load_dir.h | 85 + locking.c | 36 + locking.h | 30 + mad.c | 283 ++++ main.c | 411 +++++ mergesort.c | 83 + mergesort.h | 27 + mikmod.c | 177 ++ misc.c | 277 ++++ misc.h | 47 + mixer.h | 44 + mixer_alsa.c | 233 +++ mixer_oss.c | 252 +++ mixer_sun.c | 295 ++++ modplug.c | 245 +++ mp4.c | 596 +++++++ mpc.c | 463 ++++++ nomad.c | 871 ++++++++++ nomad.h | 103 ++ op.h | 72 + options.c | 1507 +++++++++++++++++ options.h | 187 +++ oss.c | 271 +++ output.c | 476 ++++++ output.h | 95 ++ path.c | 146 ++ path.h | 28 + pcm.c | 179 ++ pcm.h | 28 + pl.c | 144 ++ pl.h | 38 + play_queue.c | 78 + play_queue.h | 33 + player.c | 1411 ++++++++++++++++ player.h | 122 ++ prog.c | 146 ++ prog.h | 50 + pulse.c | 624 +++++++ rbtree.c | 384 +++++ rbtree.h | 223 +++ read_wrapper.c | 65 + read_wrapper.h | 29 + roar.c | 381 +++++ scripts/checks.sh | 714 ++++++++ scripts/configure.sh | 222 +++ scripts/ffmpeg_test.sh | 220 +++ scripts/gen_decomp.py | 174 ++ scripts/install | 32 + scripts/lib.mk | 148 ++ scripts/uninstall | 12 + scripts/utils.sh | 201 +++ search.c | 153 ++ search.h | 41 + search_mode.c | 301 ++++ search_mode.h | 39 + server.c | 357 ++++ server.h | 38 + sf.h | 60 + spawn.c | 110 ++ spawn.h | 24 + sun.c | 266 +++ tabexp.c | 69 + tabexp.h | 35 + tabexp_file.c | 217 +++ tabexp_file.h | 29 + track.c | 355 ++++ track.h | 103 ++ track_info.c | 228 +++ track_info.h | 131 ++ tree.c | 1183 ++++++++++++++ u_collate.c | 138 ++ u_collate.h | 77 + uchar.c | 673 ++++++++ uchar.h | 242 +++ ui_curses.c | 2448 ++++++++++++++++++++++++++++ ui_curses.h | 65 + unidecomp.h | 869 ++++++++++ utils.h | 227 +++ vorbis.c | 415 +++++ wav.c | 414 +++++ waveout.c | 315 ++++ wavpack.c | 433 +++++ window.c | 428 +++++ window.h | 98 ++ worker.c | 181 ++ worker.h | 54 + xmalloc.c | 47 + xmalloc.h | 99 ++ xstrjoin.c | 34 + xstrjoin.h | 24 + 186 files changed, 48587 insertions(+) create mode 100644 .gitignore create mode 100644 AUTHORS create mode 100644 COPYING create mode 100644 Doc/.gitignore create mode 100644 Doc/cmus-remote.txt create mode 100644 Doc/cmus-tutorial.txt create mode 100644 Doc/cmus.txt create mode 100644 Doc/ttman.c create mode 100644 Makefile create mode 100644 README create mode 100644 aac.c create mode 100644 aac.h create mode 100644 alsa.c create mode 100644 ao.c create mode 100644 ape.c create mode 100644 ape.h create mode 100644 arts.c create mode 100644 browser.c create mode 100644 browser.h create mode 100644 buffer.c create mode 100644 buffer.h create mode 100644 cache.c create mode 100644 cache.h create mode 100644 cdio.c create mode 100644 channelmap.c create mode 100644 channelmap.h create mode 100644 cmdline.c create mode 100644 cmdline.h create mode 100755 cmus-status-display create mode 100644 cmus.c create mode 100644 cmus.h create mode 100644 command_mode.c create mode 100644 command_mode.h create mode 100644 comment.c create mode 100644 comment.h create mode 100644 compiler.h create mode 100755 configure create mode 100644 contrib/README create mode 100644 contrib/_cmus create mode 100644 contrib/cmus-updategaim.py create mode 100644 contrib/cmus-updatepidgin.py create mode 100644 convert.c create mode 100644 convert.h create mode 100644 cue.c create mode 100644 cue_utils.c create mode 100644 cue_utils.h create mode 100644 data/cyan.theme create mode 100644 data/default.theme create mode 100644 data/gray-88.theme create mode 100644 data/green-mono-88.theme create mode 100644 data/green.theme create mode 100644 data/rc create mode 100644 data/xterm-white.theme create mode 100644 data/zenburn.theme create mode 100644 debug.c create mode 100644 debug.h create mode 100644 discid.c create mode 100644 discid.h create mode 100644 editable.c create mode 100644 editable.h create mode 100644 expr.c create mode 100644 expr.h create mode 100644 ffmpeg.c create mode 100644 file.c create mode 100644 file.h create mode 100644 filters.c create mode 100644 filters.h create mode 100644 flac.c create mode 100644 format_print.c create mode 100644 format_print.h create mode 100644 gbuf.c create mode 100644 gbuf.h create mode 100644 glob.c create mode 100644 glob.h create mode 100644 help.c create mode 100644 help.h create mode 100644 history.c create mode 100644 history.h create mode 100644 http.c create mode 100644 http.h create mode 100644 id3.c create mode 100644 id3.h create mode 100644 input.c create mode 100644 input.h create mode 100644 ip.h create mode 100644 iter.h create mode 100644 job.c create mode 100644 job.h create mode 100644 keys.c create mode 100644 keys.h create mode 100644 keyval.c create mode 100644 keyval.h create mode 100644 lib.c create mode 100644 lib.h create mode 100644 list.h create mode 100644 load_dir.c create mode 100644 load_dir.h create mode 100644 locking.c create mode 100644 locking.h create mode 100644 mad.c create mode 100644 main.c create mode 100644 mergesort.c create mode 100644 mergesort.h create mode 100644 mikmod.c create mode 100644 misc.c create mode 100644 misc.h create mode 100644 mixer.h create mode 100644 mixer_alsa.c create mode 100644 mixer_oss.c create mode 100644 mixer_sun.c create mode 100644 modplug.c create mode 100644 mp4.c create mode 100644 mpc.c create mode 100644 nomad.c create mode 100644 nomad.h create mode 100644 op.h create mode 100644 options.c create mode 100644 options.h create mode 100644 oss.c create mode 100644 output.c create mode 100644 output.h create mode 100644 path.c create mode 100644 path.h create mode 100644 pcm.c create mode 100644 pcm.h create mode 100644 pl.c create mode 100644 pl.h create mode 100644 play_queue.c create mode 100644 play_queue.h create mode 100644 player.c create mode 100644 player.h create mode 100644 prog.c create mode 100644 prog.h create mode 100644 pulse.c create mode 100644 rbtree.c create mode 100644 rbtree.h create mode 100644 read_wrapper.c create mode 100644 read_wrapper.h create mode 100644 roar.c create mode 100644 scripts/checks.sh create mode 100644 scripts/configure.sh create mode 100755 scripts/ffmpeg_test.sh create mode 100755 scripts/gen_decomp.py create mode 100755 scripts/install create mode 100644 scripts/lib.mk create mode 100755 scripts/uninstall create mode 100644 scripts/utils.sh create mode 100644 search.c create mode 100644 search.h create mode 100644 search_mode.c create mode 100644 search_mode.h create mode 100644 server.c create mode 100644 server.h create mode 100644 sf.h create mode 100644 spawn.c create mode 100644 spawn.h create mode 100644 sun.c create mode 100644 tabexp.c create mode 100644 tabexp.h create mode 100644 tabexp_file.c create mode 100644 tabexp_file.h create mode 100644 track.c create mode 100644 track.h create mode 100644 track_info.c create mode 100644 track_info.h create mode 100644 tree.c create mode 100644 u_collate.c create mode 100644 u_collate.h create mode 100644 uchar.c create mode 100644 uchar.h create mode 100644 ui_curses.c create mode 100644 ui_curses.h create mode 100644 unidecomp.h create mode 100644 utils.h create mode 100644 vorbis.c create mode 100644 wav.c create mode 100644 waveout.c create mode 100644 wavpack.c create mode 100644 window.c create mode 100644 window.h create mode 100644 worker.c create mode 100644 worker.h create mode 100644 xmalloc.c create mode 100644 xmalloc.h create mode 100644 xstrjoin.c create mode 100644 xstrjoin.h diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..b4636cf --- /dev/null +++ b/.gitignore @@ -0,0 +1,21 @@ +# normal ignores +.* +*~ +*.[ao] +*.lo +*.so +tags +!.gitignore + +# top-level ignores +/*.spec +/config +/config.mk +/cmus +/cmus-remote + +# Cygwin stuff +*.exe +/cmus.base +/cmus.def +/cmus.exp diff --git a/AUTHORS b/AUTHORS new file mode 100644 index 0000000..59004e2 --- /dev/null +++ b/AUTHORS @@ -0,0 +1,55 @@ +Maintainers +----------- +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 diff --git a/COPYING b/COPYING new file mode 100644 index 0000000..d159169 --- /dev/null +++ b/COPYING @@ -0,0 +1,339 @@ + 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. diff --git a/Doc/.gitignore b/Doc/.gitignore new file mode 100644 index 0000000..9b1572a --- /dev/null +++ b/Doc/.gitignore @@ -0,0 +1,4 @@ +.* +*.1 +*.7 +ttman diff --git a/Doc/cmus-remote.txt b/Doc/cmus-remote.txt new file mode 100644 index 0000000..ec524f3 --- /dev/null +++ b/Doc/cmus-remote.txt @@ -0,0 +1,137 @@ +@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*. + +When *-C* is given all command line arguments are treated as raw commands. + +@h1 OPTIONS + +--server SOCKET + Connect using socket *SOCKET* instead of `~/.cmus/socket`. + +--help + Display usage information and exit. + +--version + Display version information and exit. + +-p, --play + Start playing. + +-u, --pause + Toggle pause. + +-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 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 diff --git a/Doc/cmus-tutorial.txt b/Doc/cmus-tutorial.txt new file mode 100644 index 0000000..02d1efe --- /dev/null +++ b/Doc/cmus-tutorial.txt @@ -0,0 +1,242 @@ +@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 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 +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. + + +@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 ~/.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 | +| | ++---------------------------------------------------------------------+ +@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 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. + + +@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 +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*. + + +@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: + +`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. + diff --git a/Doc/cmus.txt b/Doc/cmus.txt new file mode 100644 index 0000000..51b30c1 --- /dev/null +++ b/Doc/cmus.txt @@ -0,0 +1,1379 @@ +@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. It has got completely configurable keybindings and +it can be controlled from the outside via *cmus-remote*(1). + +@h1 OPTIONS + +--listen ADDR + Listen to ADDR (UNIX socket) instead of `~/.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. + +--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 playlist 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, 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*. 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 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 withing 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 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 playlist (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 +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 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 win-activate +E win-add-Q +a win-add-l +y win-add-p +e win-add-q +G, end win-bottom +down, j 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 +D, delete win-remove +i win-sel-cur +space win-toggle +g, home win-top +k, 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 + `~/.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. + +player-next (*b*) + Skip to the next track. + +player-pause (*c*) + Toggle pause. + +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. + +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. + +quit [-i] (*q*, *:wq*) + Exit cmus. + + @li -i + ask before exiting + +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