/
cmus.txt
1571 lines (1119 loc) · 45.8 KB
/
cmus.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
@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.
--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<enter> 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<space>
L push live-filter<space>
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<space>
] 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 *<Stream>*.
If it is a file, it is checked if the artist and album tags are set. If not,
cmus assigns the special name *<No Name>* for the unset tag.
As the first level, cmus sorts alphanumerically by the value of the artist
tag. (<Stream> and <No Name> 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 *<Various Artists>*. Albums filed under *<Various Artists>* 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] <file|dir|url|playlist>
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] <context> <key> <command>
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 <name>
Change color scheme. Color schemes are found in `/usr/share/cmus/` or
`$XDG_CONFIG_HOME/cmus/` and have .theme filename extension.
echo <arg>...
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<enter> to exit cmus.
@endpre
factivate <user-defined-filter>...
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 <filter-expression>
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 <name>=<filter-expression>
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 <simple-filter-expression|short-filter-expression>
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] <playlist>
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 <filter-expression>
Mark tracks in playlist and queue view by using a filter expression.
pl-create <name>
Creates a new playlist.
pl-export <filename>
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 <name>
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 <text>
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
rand
Randomizes (shuffles) the tracks in the library, playlist or queue view.
refresh (*^L*)
Redraw the terminal window.
run <command>
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 [+-](<num>[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 <option>=<value>
Set value of an option. See *OPTIONS*.
set <option>
Display option value. Vim compatible *set <option>?* is also
supported.
shell <command>
Execute a command via /bin/sh.
showbind <context> <key>
Show key binding.
shuffle
Reshuffle the shuffle lists for both library and playlist views.
source <filename>
Read and execute commands from <filename>.
toggle <option>
Toggle value of a toggle-able option (all booleans and tristate
*aaa_mode*).
tqueue [NUM]
Queue NUM (default 1) random tracks from the library. See also
*lqueue*.
unbind [-f] <context> <key>
Remove a key binding. Use tab to cycle through bound keys.
-f
Don't throw an error if the binding is not known
unmark
Unmark all tracks (see *mark*).
update-cache [-f]
Update track metadata cache ($XDG_CONFIG_HOME/cmus/cache). Only files
with changed modification time or removed files are considered.
-f
Update all files. Same as quit, rm -f $XDG_CONFIG_HOME/cmus/cache, start cmus.
view <name or 1-7>
Switches active view.
vol [+-]NUM[%] [[+-]NUM[%]]
Set, increase or decrease volume.
If you give *vol* just one argument it changes both channels. Two
values make it possible to change the left and right channel
independently.
To increase or decrease volume prefix the value with *-* or *+*,
otherwise value is treated as absolute volume.
Both absolute and relative values can be given as percentage units
(suffixed with *%*) or as internal values (hardware may have volume in
range 0-31 for example).
Default bindings:
@pre
common = :vol +10%
common + :vol +10%
common - :vol -10%
common [ :vol +1% +0%
common ] :vol +0% +1%
common { :vol -1% -0%
common } :vol -0% -1%
@endpre
win-activate (*enter*)
In views 1-3 start playing the selected track. In view 5 start
playing the selected track or change to the selected directory. In
view 6 activate the selected filters. In settings view (7) change
binding or variable.
win-add-l (*a*)
Add the currently marked or selected track(s) (views 3-4), or the
currently selected file or directory (view 5) to the library.
Analogous to *:add -l*
win-add-p (*y*)
Add the currently marked or selected track(s) (views 1-2, 4), or the
currently selected file or directory (view 5) to the marked playlist.
Analogous to *:add -p*
win-add-Q (*E*)
Prepend the currently marked or selected track(s) (views 1-3), or the
currently selected file or directory (view 5) to the play queue.
Analogous to *:add -Q*
win-add-q (*e*)
Add the currently marked or selected track(s) (views 1-3), or the
currently selected file or directory (view 5) to the play queue.
Analogous to *:add -q*
win-bottom (*G*, *end*)
Goto bottom of the current window.
win-down [NUM] (*j*, *down*)
Goto down NUM (default 1) rows in the current window.
win-half-page-down
Goto down half a page in the current window.
win-half-page-up
Goto up half a page in the current window.
win-mv-after (*p*)
If no tracks are marked, move the selected track down one row. If any
tracks are marked, move the marked tracks after the currently selected
track. This command works in unsorted playlist and play queue view.
win-mv-before (*P*)
If no tracks are marked, move the selected track up one row. If any
tracks are marked, move the marked tracks before the currently
selected track. This command works in unsorted playlist and play
queue view.
win-next (*tab*)
Activate next window. Only relevant in view 1.
win-page-bottom
Goto the bottom of the visible part of the current window.
win-page-down (*^F*, *page_down*)
Goto down one page in the current window.
win-page-middle
Goto the middle of the visible part of the current window.
win-page-top
Goto the top of the visible part of the current window.
win-page-up (*^B*, *page_up*)
Go up one page in the current window.
win-remove (*D*, *delete*)
Remove the selected entry. For tracks no confirmations are made. For
playlists (view 3), files (view 5), filters (view 6) and bindings (view 7)
user has to confirm the action.
win-scroll-down (*^E*)
Scroll current window one row downwards.
win-scroll-up (*^Y*)
Scroll current window one row upwards.
win-sel-cur (*i*)
Select the current track (position in library or playlist, not
necessarily same as the currently playing track). Works only in views
1-3, does nothing in other views.
win-toggle (*space*)
Expand albums in library view (1), mark tracks in views 2-4, set the marked
playlist in view 3, toggle selection of a filter in view 6, toggle variable
value in view 7.
win-top (*g*, *home*)
Goto top of the current window.
win-up [NUM] (*k*, *up*)
Goto up NUM (default 1) rows in the current window.
win-update (*u*)
Checks the modification time of the files in the library, and updates
metadata for changed files. Removes non-existent files from the
library.
Reloads contents of directory in the browser view.
Only works in views 1-2 and 5, does nothing in other views.
win-update-cache [-f]
Same as *update-cache*, but only for marked / selected tracks.
Only works in views 1-2, does nothing in other views.
@h1 CONFIGURATION OPTIONS
This section describes cmus' options that can be altered with the *set* and
*toggle* commands. Default values are in parenthesis, possible values in
brackets.
auto_expand_albums_follow, auto_expand_albums_search, auto_expand_albums_selcur (true)
If enabled, cmus will always open an artist and select the album when
following the currently played track or performing actions such as "search"
or "go to current track". This option is tightly coupled to the
show_all_tracks option. Any "auto_expand_albums_\* = false" implies
"show_all_tracks = true".
auto_reshuffle (true)
Reshuffle playlist when end of shuffle list is reached.
aaa_mode (all) [all, artist, album]
Defines what tracks should be played in the library view. Not used in
the other views. For example if set to *artist* the player behaves
like there were only the files of the currently playing artist in the
library.
altformat_current [`Format String`]
Alternative format string for the line displaying currently playing
track.
NOTE: if empty, *format_current* is used instead.
altformat_playlist [`Format String`]
Alternative format string for the list views (2-4).
NOTE: if empty, *format_playlist* is used instead.
altformat_title [`Format String`]
Alternative format string for terminal title.
NOTE: not all terminals support changing window title.
NOTE: if empty, *format_title* is used instead.
altformat_trackwin [`Format String`]
Alternative format string for the tree view's (1) track window.
NOTE: if empty, *format_trackwin* is used instead.
buffer_seconds (10) [1-300]
Size of player buffer in seconds.
color_cmdline_bg (default) [`Color`]
Command line background color.
color_cmdline_fg (default) [`Color`]
Command line foreground color.
color_cmdline_attr (default) [`Attributes`]
Command line attributes.
color_error (lightred) [`Color`]
Color of error messages displayed on the command line.
color_info (lightyellow) [`Color`]
Color of informational messages displayed on the command line.
color_separator (blue) [`Color`]
Color of the separator line between windows in view (1).
color_statusline_bg (gray) [`Color`]
Status line background color.
color_statusline_fg (black) [`Color`]
Status line foreground color.
color_statusline_attr (default) [`Attributes`]
Status line attributes.
color_titleline_bg (blue) [`Color`]
Background color of the line displaying currently playing track.
color_titleline_fg (white) [`Color`]
Foreground color of the line displaying currently playing track.
color_titleline_attr (default) [`Attributes`]
Attributes of the line displaying currently playing track.
color_win_bg (default) [`Color`]
Window background color.
color_win_cur (lightyellow) [`Color`]
Color of currently playing track.
color_win_cur_sel_bg (blue) [`Color`]
Background color of the selected row which is also the currently
playing track in active window.
color_win_cur_sel_fg (lightyellow) [`Color`]
Foreground color of the selected row which is also the currently
playing track in active window.
color_win_cur_sel_attr (default) [`Attributes`]
Attributes of the selected row which is also the currently
playing track in active window.
color_win_dir (lightblue) [`Color`]
Color of directories in browser.
color_win_fg (default) [`Color`]
Window foreground color.
color_win_attr (default) [`Attributes`]
Window attributes.
color_win_inactive_cur_sel_bg (gray) [`Color`]
Background color of the selected row which is also the currently
playing track in inactive window.
color_win_inactive_cur_sel_fg (lightyellow) [`Color`]
Foreground color of the selected row which is also the currently
playing track in inactive window.
color_win_inactive_cur_sel_attr (default) [`Attributes`]
Attributes of the selected row which is also the currently
playing track in inactive window.
color_win_inactive_sel_bg (gray) [`Color`]
Background color of selected row in inactive window.
color_win_inactive_sel_fg (black) [`Color`]
Foreground color of selected row in inactive window.
color_win_inactive_sel_attr (default) [`Attributes`]
Attributes of selected row in inactive window.
color_win_sel_bg (blue) [`Color`]
Background color of selected row in active window.
color_win_sel_fg (white) [`Color`]
Foreground color of selected row in active window.
color_win_sel_attr (default) [`Attributes`]
Attributes of selected row in active window.
color_win_title_bg (blue) [`Color`]
Background color of window titles (topmost line of the screen).
color_win_title_fg (white) [`Color`]
Foreground color of window titles (topmost line of the screen).
color_win_title_attr (default) [`Attributes`]
Attributes of window titles (topmost line of the screen).
color_trackwin_album_bg (default) [`Color`]
Background color of the album row shown in the track window.
color_trackwin_album_fg (default) [`Color`]
Foreground color of the album row shown in the track window.
color_trackwin_album_attr (bold) [`Attributes`]
Attributes of the album row shown in the track window.
confirm_run (true)
Ask for confirmation before executing *:run*
continue (true)
Continue playing after current track finishes.
device (/dev/cdrom)
CDDA device file.
display_artist_sort_name (false)
If enabled, always displays artist names used for sorting instead of
regular ones in tree view (e.g. "Artist, The" instead of "The Artist"),
so that artists column looks alphabetically sorted.
follow (false)
If enabled, always select the currently playing track on track change.
format_current [`Format String`]
Format string for the line displaying currently playing track.
format_playlist [`Format String`]
Format string for the list views (2-4).
format_playlist_va [`Format String`]
Format string for the list views (2-4), if a track is assumed to be a
part of compilation (see `LIBRARY VIEW SORTING` for details).
NOTE: if empty, *format_playlist* is used instead.
format_statusline [`Format String`]
Format string for status line.
format_title [`Format String`]
Format string for terminal title.
NOTE: not all terminals support changing window title.
format_trackwin [`Format String`]
Format string for the tree view's (1) track window.
format_trackwin_album [`Format String`]
Format string for albums in tree view's (1) track window.
format_trackwin_va [`Format String`]
Format string for the tree view's (1) track window, if a track
is assumed to be a part of compilation (see `LIBRARY VIEW SORTING`
for details).
NOTE: if empty, *format_trackwin* is used instead.
format_treewin [`Format String`]
Format string for the tree view's (1) tree window.
format_treewin_artist [`Format String`]
Format string for artists in tree view's (1) tree window.
smart_artist_sort (true)
If enabled, makes tree view sorting ignore "The" in front of artist
names, preventing artists starting with "The" from clumping together.
Real `artistsort` tags override this option, if present.
id3_default_charset (ISO-8859-1)
Default character set to use for ID3v1 and broken ID3v2 tags.
NOTE: This is used only if the tag is not valid UTF-8.