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
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>DC - Configuration</title>
<link rel="stylesheet" type="text/css" href="doublecmd.css">
<link rel="shortcut icon" href="../../pixmaps/common/favicon.ico">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<a name="topofpage"></a>
<div class="header"><a href="index.html"><img src="../../pixmaps/common/dclogo2017.png" alt="Double Commander" height="48" width="374"></a>
<div id="global-nav" class="nav"><a title="Double Commander Home Page" href="https://doublecmd.sourceforge.io/" target="_blank">Homepage</a> | <a title="Double Commander Wiki" href="https://github.com/doublecmd/doublecmd/wiki" target="_blank">Wiki</a></div>
</div>
<div class="footer"><div class="nav"><a title="Index" href="index.html">Index</a> | <a title="Previous page" href="help.html">Previous</a> | <a title="Next page" href="shortcuts.html">Next</a></div></div>
<div class="dchelpage">
<div>
<h1>2.2. Configuration</h1>
</div>
<div>
<h2>Content</h2>
<dl>
<dt>1. <a href="#config_files">Configuration files</a></dt>
<dt>2. <a href="#settings">Configuration</a>:</dt>
<dd>
<dl>
<dt>2.1. <a href="#ConfigLang">Language</a></dt>
<dt>2.2. <a href="#ConfigBehaviors">Behaviors</a></dt>
<dt>2.3. <a href="#ConfigTools">Tools</a></dt>
<dd>
<dl>
<dt>2.3.1. <a href="#ConfigToolsViewer">Viewer</a></dt>
<dt>2.3.2. <a href="#ConfigToolsEditor">Editor</a></dt>
<dd>
<dl>
<dt>2.3.2.1. <a href="#ConfigToolsEditorHL">Highlighters</a></dt>
</dl>
</dd>
<dt>2.3.3. <a href="#ConfigToolsDiffer">Differ</a></dt>
<dt>2.3.4. <a href="#ConfigToolsTerminal">Terminal</a></dt>
</dl>
</dd>
<dt>2.4. <a href="#ConfigFonts">Fonts</a></dt>
<dt>2.5. <a href="#ConfigColor">Colors</a></dt>
<dd>
<dl>
<dt>2.5.1. <a href="#ConfigColorPanels">File panels</a></dt>
<dt>2.5.2. <a href="#ConfigColorFiles">File types</a></dt>
</dl>
</dd>
<dt>2.6. <a href="#ConfigKeys">Keys</a></dt>
<dd>
<dl>
<dt>2.6.1. <a href="#ConfigHotKeys">Hot Keys</a></dt>
</dl>
</dd>
<dt>2.7. <a href="#ConfigMouse">Mouse</a></dt>
<dd>
<dl>
<dt>2.7.1. <a href="#ConfigMouseDD">Drag & drop</a></dt>
</dl>
</dd>
<dt>2.8. <a href="#ConfigView">Files views</a></dt>
<dd>
<dl>
<dt>2.8.1. <a href="#ConfigViewEx">Files views extra</a></dt>
<dt>2.8.2. <a href="#ConfigViewBrief">Brief</a></dt>
<dt>2.8.3. <a href="#ConfigViewFull">Columns</a></dt>
<dd>
<dl>
<dt>2.8.3.1. <a href="#ConfigColumns">Custom columns</a></dt>
</dl>
</dd>
</dl>
</dd>
<dt>2.9. <a href="#ConfigPlugins">Plugins</a></dt>
<dt>2.10. <a href="#ConfigLayout">Layout</a></dt>
<dd>
<dl>
<dt>2.10.1. <a href="#ConfigDrivesList">Drives list button</a></dt>
<dt>2.10.2. <a href="#ConfigTreeMenu">Tree View Menu</a></dt>
<dt>2.10.3. <a href="#ConfigTreeMenuColor">Tree View Menu Colors</a></dt>
</dl>
</dd>
<dt>2.11. <a href="#ConfigToolbar">Toolbar</a></dt>
<dd>
<dl>
<dt>2.11.1. <a href="#ConfigToolbar">Toolbar Middle</a></dt>
<dt>2.11.2. <a href="#ConfigToolbarEx">Toolbar Extra</a></dt>
</dl>
</dd>
<dt>2.12. <a href="#ConfigOperations">File operations</a></dt>
<dd>
<dl>
<dt>2.12.1. <a href="#ConfigSearch">File search</a></dt>
<dt>2.12.2. <a href="#ConfigRename">Multi-Rename</a></dt>
</dl>
</dd>
<dt>2.13. <a href="#ConfigTabs">Folder tabs</a></dt>
<dd>
<dl>
<dt>2.13.1. <a href="#ConfigFavoriteTabs">Favorite Tabs</a></dt>
<dt>2.13.2. <a href="#ConfigTabsEx">Folder tabs extra</a></dt>
</dl>
</dd>
<dt>2.14. <a href="#ConfigLog">Log</a></dt>
<dt>2.15. <a href="#ConfigDC">Configuration</a></dt>
<dt>2.16. <a href="#ConfigQuick">Quick search/filter</a></dt>
<dt>2.17. <a href="#ConfigMisc">Miscellaneous</a></dt>
<dt>2.18. <a href="#ConfigRefresh">Auto refresh</a></dt>
<dt>2.19. <a href="#ConfigIcons">Icons</a></dt>
<dt>2.20. <a href="#ConfigIgnore">Ignore list</a></dt>
<dt>2.21. <a href="#ConfigArchivers">Archivers</a></dt>
<dt>2.22. <a href="#ConfigTooltips">Tooltips</a></dt>
<dt>2.23. <a href="#ConfigAssociations">File associations</a></dt>
<dd>
<dl>
<dt>2.23.1. <a href="#ConfigAssocEx">File associations extra</a></dt>
</dl>
</dd>
<dt>2.24. <a href="#ConfigDirHotlist">Directory Hotlist</a></dt>
<dd>
<dl>
<dt>2.24.1. <a href="#ConfigDirHotlistEx">Directory Hotlist Extra</a></dt>
</dl>
</dd>
</dl>
</dd>
</dl>
</div>
<div>
<h2><a name="config_files">1. Configuration files</a></h2>
<p>Double Commander keeps its configuration settings in files. You may configure the location of these configuration file from the <a href="#ConfigDC">Configuration</a> settings section. There is usually no need to edit these files manually, since with rare exceptions, the parameters of Double Commander are available through the program's interface.</p>
<p>The main files are:</p>
<ul>
<li><p><tt>doublecmd.xml</tt> – all the main program settings;</p></li>
<li><p><tt>doublecmd.cfg</tt> – settings that are applied before initialization of all program components and loading <tt>doublecmd.xml</tt>;</p></li>
<li><p><tt>colors.json</tt> – all color settings, Double Commander stores color values in the "Light" and "Dark" profiles and selects the profile automatically depending on the current theme (light or dark theme);</p></li>
<li><p><tt>extassoc.xml</tt> – file extension association configuration;</p></li>
<li><p><tt>favoritetabs.xml</tt> – favorite tabs;</p></li>
<li><p><tt>history.xml</tt> – command line and directory history, search and replace, etc.;</p></li>
<li><p><tt>multiarc.ini</tt> – external archivers;</p></li>
<li><p><tt>pixmaps.txt</tt> – maps file extensions to MIME-types icon names;</p></li>
<li><p><tt>session.ini</tt> – size, position and state of child program windows (these settings are saved separately for each screen resolution);</p></li>
<li><p><tt>shortcuts.scf</tt> – keyboard layout settings;</p></li>
<li><p><tt>tabs.xml</tt> – list of opened tabs;</p></li>
<li><p>few others... – etc...</p></li>
</ul>
<p>The files are generated automatically, except for <tt>multiarc.ini</tt> and <tt>pixmaps.txt</tt>: they are included in the distribution of Double Commander (in the "default" folder) and are copied to the directory of configuration files when the program is first launched.</p>
<p>The configuration version in <tt>doublecmd.xml</tt> defines the data storage format: if it has changed in the new version of the program (for example, new parameters have been added or existing ones have changed), then at the first start Double Commander will update the configuration files. The upgrade process will back up the previous version of <tt>doublecmd.xml</tt>.</p>
</div>
<div>
<h2><a name="settings">2. Configuration</a></h2>
<p>The "Options" window allows to set almost all of the options in Double Commander, but there are <a href="configxml.html">several parameters</a> that can only be changed manually in the <tt>doublecmd.xml</tt> configuration file.</p>
<p>A filter by parameter name is available at the bottom of the window: the program will display only those sections that contain a matching parameter. To open the corresponding section in the program help, you can use the <span class="italic">Help</span> button or the <kbd>F1</kbd> key.</p>
<p>Double Commander has several <a href="cmds.html#catconfiguration">internal commands</a> to open the configuration dialog and quickly jump to the desired section.</p>
<p>Double Commander supports importing/exporting some settings: directory hotlist, favorite tabs, external archivers, toolbar (main and middle), tooltips. Also, the list of hotkeys can be saved to a new file and you can switch between them.</p>
<p>Note: To the right of the file or directory choose buttons is the button <span class="italic">Some functions to select appropriate path</span> <img title="Some functions to select appropriate path" alt="Some functions to select appropriate path" src="images/imgDC/bhelper.png" width="16" height="16">: the popup menu contains lists of variables (including environment variables) and some additional functions, see description <a href="directoryhotlist.html#helperpath">here</a>.</p>
<br>
<p><span class="bold"><a name="ConfigLang">2.1. Language</a></span></p>
<p>These are the various translations available for Double Commander. You can choose your preferred language.</p>
<br>
<p><span class="bold"><a name="ConfigBehaviors">2.2. Behaviors</a></span></p>
<p>There are several parameters that affect certain behaviors of Double Commander.</p>
<p class="figure"><img class="largeimage" title="Behaviors" alt="Behaviors" src="images/imgDC/pic58.png" width="578" height="220"></p>
<p><span class="italic">Allow only one copy of DC at a time</span> – If enabled, only one copy of the program can be run. If you try to run a second copy of Double Commander, the first copy will be activated.</p>
<p><span class="italic">Move icon to system tray when minimized</span> – When minimized Double Commander will display its icon in the system tray (notification area) rather than the panel (or Windows taskbar).</p>
<p><span class="italic">Always show tray icon</span> – If enabled, in addition to the Double Commander window button on the panel (or Windows taskbar), it will additionally show the tray icon.</p>
<p><span class="italic">Drives blacklist</span> – use this to hide certain drives in the drives panel menu bar. Each item must contain the full path to the drive/mount point. Separate multiple drives with semicolons ";" without spaces. Examples: <code>/media/cdrom;/mnt/win_c</code> (Linux) or <code>a:\;b:\;d:\</code> (Windows). Also in Unix/Linux you may use wildcard mask, example for AppImage files: <code>/tmp/.mount_*</code>. Hidden drives will still be available, for example, you can open them from the Directory Hotlist menu or change the path manually.</p>
<p><span class="italic">Automatically hide unmounted devices</span> – An unmounted device will be automatically removed from the <a href="help.html#iface_drive_pane">drive button bar</a> and from the <a href="help.html#iface_drive_btn">drives list</a>.</p>
<br>
<p><span class="bold"><a name="ConfigTools">2.3. Tools</a></span></p>
<p>This section contains the settings of the built-in Double Commander tools (editor (<kbd>F4</kbd>), viewer (<kbd>F3</kbd>) and file comparison tool) and commands for launching the terminal.</p>
<p>You can specify external programs for edit, view and find differences. These external programs will be used instead of the internal tools.</p>
<br>
<p><span class="bold"><a name="ConfigToolsViewer">2.3.1. Tools > Viewer</a></span></p>
<p>There are two groups of parameters in this section:</p>
<p class="figure"><img class="largeimage" title="Viewer" alt="Viewer" src="images/imgDC/pic50.png" width="578" height="274"></p>
<p>The first group allows you to specify an external program for viewing files. Double Commander will automatically add the full filename as the last launch parameter each time the viewer is called.</p>
<p>Additionally: <span class="italic">Execute in terminal</span> and <span class="italic">Keep terminal window open after executing program</span> can be useful if you are using a console program and/or if the program's terminal output is important (or just temporarily for debugging).</p>
<p>The next group of parameters is <span class="italic">Internal viewer options</span>, however almost all parameters and switches are available in the window of <a href="viewer.html">built-in viewer</a>.</p>
<p><span class="italic">Number of columns in book viewer</span> – see description of this mode <a href="viewer.html#mnu_view">here</a>.</p>
<p>There are also <a href="configxml.html">several parameters</a> available that can only be changed manually in the <tt>doublecmd.xml</tt> configuration file.</p>
<br>
<p><span class="bold"><a name="ConfigToolsEditor">2.3.2. Tools > Editor</a></span></p>
<p class="figure"><img class="largeimage" title="Editor" alt="Editor" src="images/imgDC/pic51.png" width="578" height="362"></p>
<p>The first group of parameters allows you to specify an external program for editing text files. Double Commander will automatically add the full filename as the last launch parameter each time the editor is called.</p>
<p>Additionally: <span class="italic">Execute in terminal</span> and <span class="italic">Keep terminal window open after executing program</span> can be useful if you are using a console program and/or if the program's terminal output is important (or just temporarily for debugging).</p>
<p>Internal editor options:</p>
<p><span class="italic">Auto Indent</span> – Allows to indent the caret, when new line is created with <kbd>Enter</kbd>, with the same amount of leading white space as the preceding line.</p>
<p><span class="italic">Delete trailing spaces</span> – Auto delete trailing spaces, this applies only to edited lines.</p>
<p><span class="italic">Caret past end of line</span> – Allows caret to go into empty space beyond end-of-line position.</p>
<p><span class="italic">Show special characters</span> – Shows special characters for spaces and tabulations.</p>
<p><span class="italic">Use spaces instead tab characters</span> – Converts tab characters to a specified number of space characters (when entering).</p>
<p><span class="italic">Tab indents blocks</span> – If enabled, <kbd>Tab</kbd> and <kbd>Shift+Tab</kbd> act as block indent, unindent when text is selected.</p>
<p><span class="italic">Smart Tabs</span> – When the <kbd>Tab</kbd> key is used, caret will go to the next non-space character of the previous line.</p>
<p><span class="italic">Group Undo</span> – If enabled, all continuous changes of the same type will be processed in one call to the undo or redo command, instead of undoing/redoing each individual text change.</p>
<p><span class="italic">Tab width</span> – The width of the tab character (in number of characters). If <span class="italic">Use spaces instead tab characters</span> is enabled, then the <kbd>Tab</kbd> key will insert the specified number of space characters. This setting does not apply if the <span class="italic">Smart Tabs</span> option is enable.</p>
<p><span class="italic">Block indent</span> – sets the number of characters by which the indent will increase or decrease when using the corresponding commands.</p>
<p><span class="italic">Right margin</span> – Line length marker, thin vertical line at the given position: lines will not be truncated with a forced line break, it is just a visual hint. Useful in cases where there is a recommendation to limit the length of strings (for example, 80 or 120 characters).</p>
<br>
<p><span class="bold"><a name="ConfigToolsEditorHL">2.3.2.1. Tools > Editor > Highlighters</a></span></p>
<p>The SynEdit component is used for the built-in editor, some settings of syntax highlighting rules that are part of SynEdit are available in this section.</p>
<p class="figure"><img class="largeimage" title="Syntax highlighting" alt="Syntax highlighting" src="images/imgDC/pic52.png" width="578" height="428"></p>
<p>At the top of the window there is a drop-down menu with file types (plain text, programming and markup languages) and a field for the list of file extensions. Buttons:</p>
<ul>
<li><p><span class="italic">Save</span> – will save the changes in the list of file extensions.</p></li>
<li><p><span class="italic">Reset</span> – will reset the list to the default value.</p></li>
</ul>
<p>In the left part of the window there is a list of available elements for the selected file type, in the right part there is a preview area.</p>
<p>You can change the text and background colors and font style (underline, bold, italic and strike out) used for keywords, strings, numbers, operators, and so on. For the default text, only the text and background colors are available.</p>
<p><span class="italic">Text-mark</span> is used to add a border around the element: you can choose the color, the type of border and the type of line.</p>
<p><span class="italic">Use (and edit) global scheme settings</span> and <span class="italic">Use local scheme settings</span> are for default text only: you can change the colors for all file types at once, or only for some.</p>
<p>All settings are saved in the <tt>colors.json</tt> file.</p>
<p>Note: Possible ways to change (fix or improve) parsing of files (syntactic analysis), keyword lists, and so on:</p>
<ul>
<li>suggest changes to the Lazarus project (the best way);</li>
<li>independently make changes to the source code of the SynEdit component and compile Double Commander.</li>
</ul>
<p>In addition, Double Commander also uses the SynUniHighlighter component for syntax highlighting, see the <a href="faq.html#f4_syntax">FAQ</a> for details.</p>
<br>
<p><span class="bold"><a name="ConfigToolsDiffer">2.3.3. Tools > Differ</a></span></p>
<p>Almost all parameters and switches are available in the window of built-in differ, there are only two groups of parameters in this section.</p>
<p class="figure"><img class="largeimage" title="Differ" alt="Differ" src="images/imgDC/pic53.png" width="578" height="277"></p>
<p>The first group allows you to specify an external file comparison program. Double Commander will automatically add the full filenames as the last launch parameters each time the differ tool is called.</p>
<p>Additionally: <span class="italic">Execute in terminal</span> and <span class="italic">Keep terminal window open after executing program</span> can be useful if you are using a console program and/or if the program's terminal output is important (or just temporarily for debugging).</p>
<p><span class="italic">Position of frame panel after the comparison</span> – defines the order in which the filenames are passed to the comparison program (built-in or external):</p>
<ul>
<li><p><span class="italic">Active frame panel on left, inactive on right</span> – The file from the active file panel will be opened in the left panel of the comparison program, the second file will be opened in the right panel.</p></li>
<li><p><span class="italic">Left frame panel on left, right on right</span> – The file from the left file panel will be opened in the left panel of the comparison program, the second file will be opened in the right panel.</p></li>
</ul>
<p>If two files are selected in the active panel, the first file will be opened in the left panel of the comparison program.</p>
<br>
<p><span class="bold"><a name="ConfigToolsTerminal">2.3.4. Tools > Terminal</a></span></p>
<p>This section contains terminal launch parameters:</p>
<p class="figure"><img class="largeimage" title="Launch of the terminal" alt="Launch of the terminal" src="images/imgDC/pic54.png" width="578" height="291"></p>
<p>The first two groups are for running commands in the terminal (to indicate the position of commands to run on the command line, use <code>{command}</code> in the parameters field). They can be used in toolbar buttons, internal file associations, to launch external applications to <a href="#ConfigTools">replace</a> the built-in text editor, viewer and file comparison tool. You <a href="#ConfigAssocEx">can add</a> these actions to the file context menu (to the "Actions" submenu).</p>
<p>Also, the first group is used to open a file under the cursor in the terminal using <kbd>Shift+Enter</kbd> and to run a command from the command line (but if the <a href="help.html#iface_console">Terminal window</a> is enabled, the command will be executed in it).</p>
<p>The third group allows to specify the command that will be executed when the terminal is called (internal command <a href="cmds.html#cm_RunTerm">cm_RunTerm</a>, <kbd>F9</kbd> by default).</p>
<p>Default values:</p>
<ul>
<li><p>Windows: <tt>cmd.exe</tt></p></li>
<li><p>macOS: Double Commander will automatically detect the program specified in the system settings.</p></li>
<li><p>Linux and other Unix-like systems:</p>
<ul>
<li><p>For Debian and Debian-based distributions (Ubuntu, Linux Mint, antiX, Devuan and others), <tt>x-terminal-emulator</tt> will be used: this is a symbolic link to the terminal used in these systems by default.</p></li>
<li><p>Otherwise, Double Commander will try to get the value from the settings of the desktop environment: Cinnamon, GNOME, KDE, LXDE, LXQt, MATE or Xfce.</p></li>
<li><p>If automatic detection failed, Double Commander will use <tt>xterm</tt>.</p></li>
</ul>
</li>
</ul>
<br>
<p><span class="bold"><a name="ConfigFonts">2.4. Fonts</a></span></p>
<p class="figure"><img class="largeimage" title="Fonts" alt="Fonts" src="images/imgDC/pic28.png" width="578" height="300"></p>
<p>You can select fonts for the editor (<kbd>F4</kbd>), viewer (<kbd>F3</kbd>), file panels (<span class="italic">Main Font</span>) and other elements of the Double Commander interface, and also their size. The bottom line for each allows you to see how the display of the selected font looks. One important note: the fonts for the editor and viewer must be <span class="red">MONOSPACE</span>. The figure below illustrates a proportionally spaced font in the window above (notice the strange spacing) and a monospace font in the window below which appears correctly spaced. Also, with some proportional fonts the characters may overwrite each other and look quite strange.</p>
<p class="figure"><img class="largeimage" title="Font Differences" alt="Font Differences" src="images/imgDC/pic29.png" width="576" height="360"></p>
<p>Normal (proportional) font above, monospaced below.</p>
<p>Also you can use <kbd>Ctrl</kbd>+mouse wheel to change the font size, this function works for the following interface elements or part of Double Commander:</p>
<ul>
<li><p>file list in left and right panels;</p></li>
<li><p>current directory (address) bar;</p></li>
<li><p>function key buttons bar;</p></li>
<li><p>TreeView menu;</p></li>
<li><p>search results in find files dialog;</p></li>
<li><p>internal editor;</p></li>
<li><p>internal viewer (if viewer shows text then this action will change font size, if image then action will work as zoom in/zoom out commands).</p></li>
</ul>
<p>Also you can choose the type of font rasterization (regardless of the system settings), see description of <a href="configxml.html"><Quality></a>.</p>
<br>
<p><span class="bold"><a name="ConfigColor">2.5. Colors</a></span></p>
<p>This section contains color settings that are not included in other settings sections. The parameters are grouped by category.</p>
<p class="figure"><img class="largeimage" title="Colors: Dark mode" alt="Colors: Dark mode" src="images/imgDC/pic59.png" width="578" height="155"></p>
<p>1. <span class="italic">Dark mode</span> – enables or disables dark mode support (only macOS and Windows 10 1809 and newer). State:</p>
<ul>
<li><p><span class="italic">Auto</span> – system settings will be used.</p></li>
<li><p><span class="italic">Enabled</span> – enable forcibly.</p></li>
<li><p><span class="italic">Disabled</span> – disable forcibly.</p></li>
</ul>
<p>2. <span class="italic">Viewer</span> – color settings that are used by the built-in <a href="viewer.html">file viewer</a> (see description of viewing modes <a href="viewer.html#mnu_view">here</a>):</p>
<p><span class="italic">Book Mode</span> – for the "Book" viewing mode, you can set the text color and background color.</p>
<p><span class="italic">Image Mode</span>:</p>
<ul>
<li><p><span class="italic">Background 1:</span> – sets the background color of the window when viewing images.</p></li>
<li><p><span class="italic">Background 2:</span> – if <a href="viewer.html#mnu_image">Show transparency</a> is enabled, the internal viewer indicates transparency using a checkerboard pattern as background and <span class="italic">Background 2</span> defines the color of the squares. If not set, the viewer will automatically calculate the value: for a dark background, light squares will be used and vice versa.</p></li>
</ul>
<p>3. <span class="italic">Differ</span> – for the internal <a href="help.html#cm_CompareContents">Differ tool</a>: you can change the colors for added, deleted and modified lines, and the color for different characters in binary mode.</p>
<p>4. <span class="italic">Log</span> – options that set the text colors in the log window for informational messages, error messages, and messages about successful operations. Also, these colors are used in the window with the result of <a href="help.html#cm_CheckSumVerify">verifying checksums</a>.</p>
<p>5. <span class="italic">Synchronize Directories</span> – for the internal <a href="syncdirs.html">directory synchronization</a> tool:</p>
<ul>
<li><p><span class="italic">Left:</span> – files selected for copying or deleting on the left.</p></li>
<li><p><span class="italic">Right:</span> – files selected for copying or deleting on the right.</p></li>
<li><p><span class="italic">Unknown:</span> – files with the same names, but not identical.</p></li>
</ul>
<p>6. <span class="italic">Drive Free Space Indicator</span> – here you can change the appearance of the drive free space indicator:</p>
<p class="figure"><img class="largeimage" title="Colors: Free Space Indicator" alt="Colors: Free Space Indicator" src="images/imgDC/pic81.png" width="578" height="196"></p>
<p>Double Commander can display a gradient (from green to red) or simple monochrome indicator, in the second case you can choose the color and background. <span class="italic">Indicator Threshold Color</span> will be used if the free disk space is less than 10%.</p>
<p>The indicator example is clickable, so you can see how it will look.</p>
<br>
<p><span class="bold"><a name="ConfigColorPanels">2.5.1. Colors > File panels</a></span></p>
<p>This section contains settings for the appearance of file panels:</p>
<p class="figure"><img class="largeimage" title="Color settings" alt="Color settings" src="images/imgDC/pic30.png" width="804" height="459"></p>
<p>The color settings here are global settings for both file panels. These settings can be overridden by creating a customised column style which can have its own color settings, and more, for each tab in the panel! See <a href="#ConfigColumns">Files views > Columns > Custom columns</a> for details on how to do this. You should adjust the current style of the columns (<span class="italic">Default</span> by default) or create your own style and apply it for any tab.</p>
<p>Here you can choose colors that will be used to process the file panels: <span class="italic">Text Color</span>, <span class="italic">Background</span>, <span class="italic">Background 2</span>, <span class="italic">Mark Color</span>, <span class="italic">Cursor Color</span>, <span class="italic">Cursor Text</span>, <span class="italic">Inactive Cursor Color</span>, <span class="italic">Inactive Mark Color</span>, and also <span class="italic">Cursor border</span> (if you are not using a frame cursor). With the two background options you can make an alternating stripe in the panels, as in some screenshots.</p>
<p><span class="italic">Use Inverted Selection</span> – inverts colors of marked text and marked text under cursor.</p>
<p><span class="italic">Use Inactive Sel Color</span> – enables the display of the cursor also in the inactive panel.</p>
<p><span class="italic">Use Frame Cursor</span> – Double Commander will use a frame instead of a solid rectangle.</p>
<p><span class="italic">Allow Overcolor</span> enables the ability to use a color other than the default color for file names (see section <a href="#ConfigColorFiles">Colors > File types</a>).</p>
<p>In the <span class="italic">Current Path</span> parameter group, you can change the text color and background color of the <a href="help.html#iface_dir">current directory bar</a> for the active and inactive file panel.</p>
<p>Also here you can decrease the brightness of the inactive panel.</p>
<p>There is a preview area at the bottom of the window, so you can see all the changes at once.</p>
<p>The <span class="italic">Reset to DC default</span> button will reset all parameters to their default values.</p>
<p>The grid color can also be changed, but only manually. You need to close the application, open the <a href="#config_files">colors.json</a> file and replace the value of the <code>GridLine</code> key in the <code>FilePanel</code> object. (Don't forget that the colors in <tt>colors.json</tt> are stored in two profiles: "Light" for light themes and "Dark" for dark themes.)<br>
About color format: Double Commander stores color values in the <code>$BBGGRR</code> format as a decimal number. For example, if you want to use the indigo color <code>#4B0082</code> (<code>$RRGGBB</code>), then do the rearrangement, you will get <code>82004B</code> and now you need to convert this hexadecimal number to decimal. Or you can temporarily add a color for some type of file (see below), find it in <tt>colors.json</tt> by name or mask, copy the value and delete.</p>
<br>
<p><span class="bold"><a name="ConfigColorFiles">2.5.2. Colors > File types</a></span></p>
<p>Here you can specify file types that should be given a different color. The <a href="#ConfigColorPanels">Allow Overcolor</a> parameter must be enabled (enabled by default).</p>
<p class="figure"><img class="largeimage" title="File types by color" alt="File types by color" src="images/imgDC/pic31.png" width="578" height="353"></p>
<p>In line <span class="italic">Category name</span> you may write a description of the file, what it does or what program it opens.</p>
<p>In line <span class="italic">Category mask</span> put a wildcard mask to match file types (symbol "*" means match any number of characters, symbol "?" means any one character). You may put multiple file types here using a semicolon ";" without spaces between them. Also you can use search templates (<img title="Template..." alt="Template..." src="images/imgDC/btemplate.png" width="16" height="16">), including search with content plugins.</p>
<p>In line <span class="italic">Category attributes</span> you can put file attributes, and DC will match any files which have matching attributes (not available if using a search template). File attributes are specified by the following templates:</p>
<ul>
<li><p>Windows: [<code>d</code> or <code>l</code>]<code>rahs</code>[<code>c</code> or <code>e</code>]<code>tp</code></p></li>
<li><p>Unix/Linux: [<code>b</code>, <code>c</code>, <code>d</code>, <code>f</code>, <code>l</code> or <code>s</code>]<code>rwxrwxrwx</code></p></li>
</ul>
<p>i.e. the template must match the attribute text string in the file list. Description of values:</p>
<table>
<tr class="rowcategorytitle"><th colspan="2">Attributes in Windows</th></tr>
<tr class="rowsubtitle"><th class="namecolumn">Attribute letter</th><th class="categorydesccolumn">What it stands for</th></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">a</div></td><td class="hintcell">archive</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">c</div></td><td class="hintcell">compressed (NTFS compression)</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">d</div></td><td class="hintcell">directory</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">e</div></td><td class="hintcell">encrypted (EFS encryption)</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">h</div></td><td class="hintcell">hidden</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">l</div></td><td class="hintcell">symlink</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">p</div></td><td class="hintcell">sparse</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">r</div></td><td class="hintcell">read only</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">s</div></td><td class="hintcell">system</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">t</div></td><td class="hintcell">temporary</td></tr>
</table>
<br>
<table>
<tr class="rowcategorytitle"><th colspan="2">Attributes in Unix/Linux (File Types)</th></tr>
<tr class="rowsubtitle"><th class="namecolumn">File Types letters</th><th class="categorydesccolumn">What it stands for</th></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">b</div></td><td class="hintcell">block device</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">c</div></td><td class="hintcell">character device</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">d</div></td><td class="hintcell">directory</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">f</div></td><td class="hintcell">named pipe (FIFO)</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">l</div></td><td class="hintcell">symlink</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">s</div></td><td class="hintcell">socket</td></tr>
</table>
<br>
<p>The second part of the Unix/Linux template displays permissions: read (r), write (w), execute (x). The values are grouped in groups of three in the following order: user (owner), user's group, all others.</p>
<p>If attribute should not be set, it must be replaced with the "-" symbol, unnecessary attributes should be hidden: symbol "*" means match any number of characters, symbol "?" means any one character. For example, <code>?r*</code> (Windows) or <code>?r-*</code> (Linux) will find all read-only files and folders.</p>
<p>You can use a color from the list or specify yours using the ".." button.</p>
<p>Do not forget to click "Apply" button after customization.</p>
<p>Double Commander checks the list from top to bottom until the first match: a rule higher in the list will overlap any rule below.</p>
<br>
<p><span class="bold"><a name="ConfigKeys">2.6. Keys</a></span></p>
<p class="figure"><img class="largeimage" title="Keys" alt="Keys" src="images/imgDC/pic60.png" width="578" height="168"></p>
<p>Here you can set the action on pressing some keys in the active file panel: <span class="italic">Letters</span>, <span class="italic">Alt+Letters</span>, <span class="italic">Ctrl+Alt+Letters</span>. You can choose one of the following actions: do nothing, set focus to command line and enter command, run <p><a href="help.html#cm_QuickSearch">quick search or quick filter</a>.</p>
<p><span class="italic">Left, Right arrows change directory (Lynx-like movement)</span> – <kbd>right arrow</kbd> opens directory or runs a program under cursor, <kbd>left arrow</kbd> opens parent directory (only in the <a href="help.html#iface_files">full mode</a>).</p>
<br>
<p><span class="bold"><a name="ConfigHotKeys">2.6.1. Keys > Hot Keys</a></span></p>
<p>In this section you can set keys to launch commands and also specify parameters for these commands.</p>
<p class="figure"><img class="largeimage" title="Hot Keys" alt="Hot Keys" src="images/imgDC/pic32.png" width="612" height="440"></p>
<p><span class="italic">Shortcut files</span> – A drop-down menu containing a list of files with a set of hotkeys. They are stored in the directory with program settings files.</p>
<p>On the right is the file related menu button:</p>
<ul>
<li><p>Actions with the current file: <span class="italic">Save now</span>, <span class="italic">Rename</span>, <span class="italic">Copy</span> and <span class="italic">Delete</span>.</p></li>
<li><p><span class="italic">Restore DC default</span>.</p></li>
<li><p>Commands for switching to the previous and next categories.</p></li>
<li><p>Commands for switching the sort order of the command table (see below).</p></li>
</ul>
<p><span class="italic">Categories</span> – shows the category of hot key combinations:
<span class="italic">Main</span>,
<span class="italic">Copy/Move Dialog</span>,
<span class="italic">Differ</span>,
<span class="italic">Edit Comment Dialog</span>,
<span class="italic">Editor</span>,
<span class="italic">Find files</span>,
<span class="italic">Multi-Rename Tool</span>,
<span class="italic">Synchronize Directories</span>,
<span class="italic">Viewer</span>.
</p>
<p><span class="italic">Filter</span> – enables you to search the internal commands more quickly.</p>
<p><span class="italic">Sort order</span> – switchs the sort order of the command table:</p>
<ul>
<li><p><span class="italic">By command name</span>.</p></li>
<li><p><span class="italic">By shortcut key (grouped)</span> – If multiple hotkeys are assigned, they will be listed separated by semicolon ";".</p></li>
<li><p><span class="italic">By shortcut key (one per row)</span>.</p></li>
</ul>
<p><span class="italic">Commands</span> – list of available <a href="cmds.html">internal commands</a> in Double Commander. The list is shown as a table with three columns:</p>
<ul>
<li><p>Command (name of internal command).</p></li>
<li><p>Hotkeys (assigned shortcuts).</p></li>
<li><p>Description (a short description).</p></li>
</ul>
<p>The table at the bottom of the window shows assigned keyboard shortcuts, parameters, and interface elements (see below) for the selected command.</p>
<p><span class="italic">Add hotkey</span> – will open a window for adding hotkeys.</p>
<p><span class="italic">Edit hotkey</span> – will open the same window, but with the hotkey and other options already set.</p>
<p><span class="italic">Delete hotkey</span> – will delete the hotkey selected in the list.</p>
<p>A window for adding hotkeys:</p>
<p class="figure"><img class="largeimage" title="Add new hotkey" alt="Add new hotkey" src="images/imgDC/pic33.png" width="418" height="440"></p>
<p><span class="italic">Shortcuts</span> – new shortcut displays here. Click in the box and press combination on keyboard to enter new hot key. If the new combination is already being used for another command, Double Commander will show a warning.</p>
<p><span class="italic">Parameters (each in a separate line):</span> – allows to set some parameters for the command. Most parameters must be added as <span class="italic">parameter=value</span> (unless otherwise stated), each must be in a separate line, without quotes and other ways of escaping special characters and spaces. The button below will open a description of the command in the <a href="cmds.html">corresponding help file</a> of Double Commander.</p>
<p><span class="italic">Only for these controls</span> – The hotkey will only work if the selected interface element(s) has focus: command line, files or quick search panel.</p>
<p>The following buttons are located on the right side of the window:</p>
<ul>
<li><p>The <span class="italic">F1</span> button will show a menu with a list of free available keyboard shortcuts, grouped by alphabet and modifiers.</p></li>
<li><p>The "+" button will add another field for the keyboard shortcut (up to five).</p></li>
<li><p>The "-" button will delete last shortcut from list.</p></li>
</ul>
<p>You can set multiple hotkeys for an internal command in two ways: use the <span class="italic">Add hotkey</span> button and then the "+" button several times or the <span class="italic">Add hotkey</span> button several times. The second way allows to use the selected command with different parameters.</p>
<br>
<p><span class="bold"><a name="ConfigMouse">2.7. Mouse</a></span></p>
<p class="figure"><img class="largeimage" title="Mouse" alt="Mouse" src="images/imgDC/pic61.png" width="578" height="324"></p>
<p>The first group of parameters is <span class="italic">Selection</span>:</p>
<ul>
<li><p><span class="italic">Selection by mouse</span> – enables the ability to select and unselect files and folders with the mouse.</p></li>
<li><p><span class="italic">By clicking on icon</span> – allows to select files with one mouse click on their icons. Selection by clicking on icon in thumbnail view works when you click on left part (1/4 or 25%) of image.</p></li>
<li><p><span class="italic">Mode</span> – sets the left or right mouse button.</p></li>
</ul>
<p>See the <a href="help.html#select_files">Selecting files</a> subsection for details.</p>
<p><span class="italic">Scrolling</span> – the ability to use the mouse wheel to scroll the list of files in the panels:</p>
<ul>
<li><p><span class="italic">Line by line with cursor movement</span> – cursor will move up or down the panel before scrolling takes place.</p></li>
<li><p><span class="italic">Line by line</span> – the cursor remains on the file and scrolling takes place immediately. Also you can specify the number of lines.</p></li>
<li><p><span class="italic">Page by page</span> – the same as previous, but scrolling is by pages rather than by lines (much faster scrolling).</p></li>
</ul>
<p><span class="italic">Open with</span> – will determine what will launch the action when you are using the mouse button on an element from the displayed file list in a panel:</p>
<ul>
<li><p>A double click is necessary to launch the action (default).</p></li>
<li><p>A single click opens files and folders.</p></li>
<li><p>A single click only opens folders. For files, a double click is needed.</p></li>
</ul>
<p><span class="italic">The text cursor no longer follows the mouse cursor</span> – is used for the last two values. If single click is enabled, by default the text cursor will follow the mouse cursor: this helps to avoid accidentally opening files or folders. You can disable it if you don't need it (or don't like it).</p>
<br>
<p><span class="bold"><a name="ConfigMouseDD">2.7.1. Mouse > Drag & drop</a></span></p>
<p>This section contains settings related to <a href="help.html#draganddrop">drag & drop</a>.</p>
<p class="figure"><img class="largeimage" title="Mouse > Drag & drop" alt="Mouse > Drag & drop" src="images/imgDC/pic62.png" width="578" height="284"></p>
<p><span class="italic">Show confirmation dialog after drop</span> – helps to avoid accidental errors when using drag and drop files inside the active file panel or between panels: Double Commander will show a confirmation dialog as for normal copying or moving files.</p>
<p>The next feature is available in Windows only: you can drag and drop text selected in a web browser or word processor (for example, LibreOffice Writer or Microsoft Word) to the panel and save it. Here you can choose file format (RTF, HTML or plain text file), encoding and enable automatic name generation.</p>
<br>
<p><span class="bold"><a name="ConfigView">2.8. Files views</a></span></p>
<p>In this section, you can set various file sorting options and date/time and size formats.</p>
<p class="figure"><img class="largeimage" title="Files views: sorting and formatting" alt="Files views: sorting and formatting" src="images/imgDC/pic34.png" width="710" height="426"></p>
<p><span class="italic">Sort method</span> – sets the sorting method in the file panels:</p>
<ul>
<li><p><span class="italic">Alphabetical, considering accents</span> – This method will sort alphabetically, taking into account the peculiarities of the system language and regional settings: also additional characters will be taken into account (for example, umlaut and other diacritical characters in Germanic languages or the letter "Ñ‘" in Russian).</p></li>
<li><p><span class="italic">Alphabetical with special characters sort</span> – Like the previous method, but additionally the list will be sorted by special characters and punctuation marks before letters.</p></li>
<li><p><span class="italic">Natural sorting: alphabetical and numbers</span> – This method will sort digits as numbers: for example, "3" will be show before "20" because 20 is larger than 3.</p></li>
<li><p><span class="italic">Natural with special characters sort</span> – Like the previous method, but also with sorting by special characters and punctuation marks.</p></li>
</ul>
<p><span class="italic">Case sensitivity</span> – complements the selected method:</p>
<ul>
<li><p>not case sensitive;</p></li>
<li><p>according to locale settings (aAbBcC);</p></li>
<li><p>first upper then lower case (ABCabc).</p></li>
</ul>
<p><span class="italic">Sorting directories</span> – sets the position of directories in the file list:</p>
<ul>
<li><p>sort by name and show first;</p></li>
<li><p>sort like files and show first;</p></li>
<li><p>sort like files.</p></li>
</ul>
<p><span class="italic">Insert new files</span> – sets the position of the new file in the list:</p>
<ul>
<li><p>at the top of the file list;</p></li>
<li><p>after directories (if directories are sorted before files);</p></li>
<li><p>at sorted position;</p></li>
<li><p>at the bottom of the file list.</p></li>
</ul>
<p><span class="italic">Move updated files</span> – sets the position if the file property currently used for sorting was changed (modification date, size, etc.):</p>
<ul>
<li><p>don't change position;</p></li>
<li><p>use the same setting as for new files;</p></li>
<li><p>to sorted position.</p></li>
</ul>
<p>The first parameter in the <span class="italic">Formatting</span> group is <span class="italic"><a name="dt_format">Date and time format</a></span>. You can choose one of the existing templates from the drop-down list or set your own using date and time formatting characters.</p>
<p>Formatting characters are presented below (based on <a title="Free Pascal: Date and time format" href="https://www.freepascal.org/docs-html/rtl/sysutils/formatchars.html" target="_blank">Free Pascal documentation</a>). Some values depend on the regional settings of the operating system!</p>
<p>As example we will use 2021.01.24 09:06:02 (i.e. <code>yyyy.mm.dd hh:mm:ss</code>) and the USA region.</p>
<table>
<tr class="rowcategorytitle"><th colspan="3">Possible characters</th></tr>
<tr class="rowsubtitle"><th class="smallname">Characters</th><th class="categorydesccolumn">Description</th><th class="categorynamecolumn">Example</th></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">c</div></td><td class="hintcell">short date format and long time format if the time is not zero</td><td class="hintcell">1/24/2021 9:06:02</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">f</div></td><td class="hintcell">same as <tt>c</tt>, but adds the time even if it is zero</td><td class="hintcell">1/24/2021 9:06:02</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">d</div></td><td class="hintcell">day of month</td><td class="hintcell">24</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">dd</div></td><td class="hintcell">day of month (leading zero)</td><td class="hintcell">24</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">ddd</div></td><td class="hintcell">day of week (abbreviation)</td><td class="hintcell">Sun</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">dddd</div></td><td class="hintcell">day of week (full)</td><td class="hintcell">Sunday</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">ddddd</div></td><td class="hintcell">short date format</td><td class="hintcell">1/24/2021</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">dddddd</div></td><td class="hintcell">long date format</td><td class="hintcell">Sunday, January 24, 2021</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">m</div></td><td class="hintcell">month or minutes if preceded by <tt>h</tt> or <tt>hh</tt> specifiers</td><td class="hintcell">1</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">mm</div></td><td class="hintcell">month or minutes if preceded by <tt>h</tt> or <tt>hh</tt> specifiers, with leading zero</td><td class="hintcell">01</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">mmm</div></td><td class="hintcell">month (abbreviation)</td><td class="hintcell">Jun</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">mmmm</div></td><td class="hintcell">month (full)</td><td class="hintcell">January</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">yy</div></td><td class="hintcell">year (two digits)</td><td class="hintcell">21</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">yyyy</div></td><td class="hintcell">year (with century)</td><td class="hintcell">2021</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">h</div></td><td class="hintcell">hour</td><td class="hintcell">9</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">hh</div></td><td class="hintcell">hour (leading zero)</td><td class="hintcell">09</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">n</div></td><td class="hintcell">minute</td><td class="hintcell">6</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">nn</div></td><td class="hintcell">minute (leading zero)</td><td class="hintcell">06</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">s</div></td><td class="hintcell">second</td><td class="hintcell">2</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">ss</div></td><td class="hintcell">second (leading zero)</td><td class="hintcell">02</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">z</div></td><td class="hintcell">milliseconds</td><td class="hintcell">1</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">zzz</div></td><td class="hintcell">milliseconds (leading zero)</td><td class="hintcell">001</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">t</div></td><td class="hintcell">short time format</td><td class="hintcell">9:06</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">tt</div></td><td class="hintcell">long time format</td><td class="hintcell">9:06:02</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">am/pm</div></td><td class="hintcell">use 12 hour clock and display am and pm accordingly (also <tt>AM/PM</tt>, <tt>a/m</tt> or <tt>A/M</tt>); for example, <code>t AM/PM</code></td><td class="hintcell">9:06 am</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">/</div></td><td class="hintcell">insert date separator</td><td class="hintcell">/</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">:</div></td><td class="hintcell">insert time separator</td><td class="hintcell">:</td></tr>
<tr><td class="varcell"><div class="firstcolumnaleft">"text"</div></td><td class="hintcell">literal text; for example, <code>yyyy "AD"</code></td><td class="hintcell">2021 AD</td></tr>
</table>
<p>The next parameters sets the file size format:</p>
<ul>
<li><p><span class="italic">File size format</span> – will be used in the file panels.</p></li>
<li><p><span class="italic">Header format</span> – will be used in the drives list and free space label.</p></li>
<li><p><span class="italic">Footer format</span> – will be used in the status bar of the file panels.</p></li>
<li><p><span class="italic">Operation size format</span> – will be used in the file operations dialogs: copying, moving, calculating checksums and so on.</p></li>
</ul>
<p>Also on the right you can set the number of digits after the decimal separator (i.e. separator for integer and fractional parts of a number): 0, 1, 2 or 3.</p>
<p>File size units: bytes, kilobytes, megabytes, gigabytes, terabytes or float (Double Commander will choose the unit automatically based on the size).</p>
<p>"Personalized" in the name means that Double Commander will use <span class="italic">Personalized abbreviations</span> from the list below. The <span class="italic">Default</span> button will reset their to the default values for the selected language (specified in the corresponding language file).</p>
<br>
<p><span class="bold"><a name="ConfigViewEx">2.8.1. Files views > Files views extra</a></span></p>
<p class="figure"><img class="largeimage" title="Files views extra" alt="Files views extra" src="images/imgDC/pic63.png" width="628" height="383"></p>
<p>Marking/Unmarking entries:</p>
<ul>
<li><p><span class="italic">Windows style filter when marking files ("*.*" also select files without extension, etc.)</span> – By default, the mask "*.*" matches the name of any file that has an extension, for any file names use the mask "*". If enabled, the mask "*.*" will match any file.</p></li>
<li><p><span class="italic">Default attribute mask value to use</span> – will be used for the following commands:
<span class="italic">Select All</span> (<tt>cm_MarkMarkAll</tt>),
<span class="italic">Unselect All</span> (<tt>cm_MarkUnmarkAll</tt>),
<span class="italic">Invert Selection</span> (<tt>cm_MarkInvert</tt>),
<span class="italic">Select a Group</span> (<tt>cm_MarkPlus</tt>)
and <span class="italic">Unselect a Group</span> (<tt>cm_MarkMinus</tt>).
For example, if you want these commands to work only with files, specify <code>d-</code>.
The <span class="italic">Add</span> button will open the file attributes selection window, you can use it or enter them manually. For more information about file attributes and their use, see <a href="findfiles.html#attributes">here</a>.</p></li>
<li><p><span class="italic">Use an independent attribute filter in mask input dialog each time</span> – If enabled, the attribute filter will be added to the <span class="italic">Select a Group</span> (<tt>cm_MarkPlus</tt>) and <span class="italic">Unselect a Group</span> (<tt>cm_MarkMinus</tt>) command dialogs.</p></li>
</ul>
<p><span class="italic">When selecting files with <SPACEBAR>, move down to next file (as with <INSERT>)</span> – moves the cursor down on selection with the <kbd>Space</kbd> key. Default keys are <kbd>Shift+Down</kbd> or <kbd>Shift+Up</kbd>.</p>
<p><span class="italic">Show square brackets around directories</span> – helps to visually distinguish directories from files when icons are disabled. Also you can use any symbols instead them, see description of <code><FolderPrefix></code> and <code><FolderPostfix></code> parameters <a href="configxml.html">here</a>.</p>
<p><span class="italic"><a name="show_hidden">Show system and hidden files</a></span> – If enabled, Double Commander will show files and folders which have the "hidden" or "system" attribute (Windows) or the name with a dot character in the beginning (Linux and other Unix-like systems). This can also can be changed from the <a href="help.html#cm_ShowSysFiles">main menu</a>.</p>
<p>The parameters <span class="italic">Load file list in separate thread</span> and <span class="italic">Load icons after file list</span> are designed to speed up the display of the list of files in the panel, i.e.the application window will hang less when opening large directories.</p>
<p><span class="italic">Don't load file list until a tab is activated</span> – When launched, Double Commander will not load the list of files of inactive tabs that were opened in the previous session.</p>
<p><span class="italic">Highlight new and updated files</span> – If enabled, the names of files that are currently being created or modified will flash.</p>
<p><span class="italic">Enable inplace renaming when clicking twice on a name</span> – is an additional ability to rename the file using the left mouse click (it does not depend on the the chosen key for selection with the mouse), as in Windows Explorer. After clicking, the mouse cursor must stay still for at least one second. In the <a href="#ConfigMouse">mouse settings</a> section, double click for files and folders or just files should be selected.</p>
<p><span class="italic">Enable changing to parent folder when double-clicking on empty part of file view</span> – is an additional feature to simplify directory navigation. But not applicable if you are using a column set and the list of files in the current directory does not fit in the panel (i.e. you see a vertical scroll bar).</p>
<br>
<p><span class="bold"><a name="ConfigViewBrief">2.8.2. Files views > Brief</a></span></p>
<p>There are only two parameters here.</p>
<p class="figure"><img class="largeimage" title="Files views > Brief" alt="Files views > Brief" src="images/imgDC/pic64.png" width="578" height="184"></p>
<p><span class="italic">Show file extensions</span>: <span class="italic">directly after filename</span> or <span class="italic">aligned (with Tab)</span>. In the second case, file extensions will be shown separately, aligned to the right side of the columns.</p>
<p><span class="italic">Columns size</span>: Double Commander will set the size automatically (the size will depend on the length of the filenames) or you can set the width of the columns (in pixels) or their count.</p>
<br>
<p><span class="bold"><a name="ConfigViewFull">2.8.3. Files views > Columns</a></span></p>
<p class="figure"><img class="largeimage" title="Files views > Columns" alt="Files views > Columns" src="images/imgDC/pic65.png" width="578" height="306"></p>
<p>First group is <span class="italic">Show grid</span>:</p>
<ul>
<li><p><span class="italic">Vertical lines</span> – enables vertical grid lines in the panels.</p></li>
<li><p><span class="italic">Horizontal lines</span> – enables horizontal grid lines in the panels.</p></li>
</ul>
<p>The screenshots below illustrate this subtle grid effect. The screenshot on the left has the vertical and horizontal lines enabled and the screenshot on the right does not.</p>
<p class="figure"><img class="largeimage" title="with and without lines" alt="with and without lines" src="images/imgDC/pic35.png" width="690" height="128"></p>
<p>It is possible to change the color of the lines, see more details <a href="#ConfigColorPanels">here</a>.</p>
<p><span class="italic">Auto fill columns</span> – If enabled, when resizing the window (or if free space exists), Double Commander will resize the column, which selected in the next option <span class="italic">Auto size column:</span> (first or last). The horizontal scrollbar will not be available.</p>
<p><span class="italic">Column titles alignment like values</span> – If enabled, Double Commander will align the column header the same as the content (instead of left-aligned).</p>
<p>If the content of the column is larger than its width:</p>
<ul>
<li><p><span class="italic">Cut text to column width</span> – Sometimes column text can overlap into other columns. This option truncates any extra text at the column boundary.</p></li>
<li><p><span class="italic">Extend cell width if text is not fitting into column</span> – If the text does not fit and the adjacent cell is empty, then the text will also occupy the adjacent cell.</p></li>
</ul>
<br>
<p><span class="bold"><a name="ConfigColumns">2.8.3.1. Files views > Columns > Custom columns</a></span></p>
<p>In this section you can customize the panel appearance, columns, colors, fonts, etc. Double Commander is very configurable in this way.</p>
<p class="figure"><img class="largeimage" title="Custom columns" alt="Custom columns" src="images/imgDC/pic36.png" width="884" height="464"></p>
<p>There is a preview area at the bottom of the window, so you can see all the changes at once. You may move cursor and select files to get immediately an actual look and feel of the various settings.</p>
<p><span class="italic">File system</span> – allows to switch to columns settings for WFX plugins (if installed plugins support it).</p>
<p><span class="italic">Columns view</span> – a list of existing column styles. There is one default style <span class="italic">Default</span>.</p>
<p><span class="italic">Save</span> – saves changes in the selected set of columns.</p>
<p><span class="italic">Save as</span> – allows to save the selected column set (as is or with changes) with a new name.</p>
<p><span class="italic">New</span> – creates a new column set based on the selected one. With the same name + current date and time.</p>
<p><span class="italic">Rename</span> – will prompt to enter a new name.</p>
<p><span class="italic">Delete</span> – deletes selected column set.</p>
<p>Below is a table with columns of the selected set, here you can set the number, name, content, place and size of columns. The count of lines in the table is equal to the count of columns in the set. Adding a new column: use the <kbd>down arrow</kbd> key or right-click in the empty area near the table and select <span class="italic">Add column</span>.</p>
<p>These are the parameters that determine the table for the column (click in the boxes to edit them):</p>
<p class="figure"><img class="largeimage" title="Columns" alt="Columns" src="images/imgDC/pic37.png" width="612" height="46"></p>
<p><span class="italic">Column</span> – shows the indicator of the selected column.</p>
<p><span class="italic">Caption</span> – specifies the name of the column which will be displayed in the <a href="help.html#iface_columns">tabstop headers bar</a>. You can set any name you like.</p>
<p><span class="italic">Width</span> – column width (in pixels) which will be set on program start. Note: the width depends on the column content, e.g. the file extension column will have a small width.</p>
<p><span class="italic">Align</span> – sets the alignment of the content of the column. Variants are:</p>
<ul>
<li><p><tt>"<-"</tt> – align left;</p></li>
<li><p><tt>"->"</tt> – align right;</p></li>
<li><p><tt>"="</tt> – align middle.</p></li>
</ul>
<p><span class="italic">Field contents</span> – sets the basic content of the column. When a cell is selected, the "+" button will appear on its right side, you can choose internal fields of Double Commander (submenu "DC") or fields of installed WDX plugins (submenu "Plugins"). List of internal fields:</p>
<ul>
<li><p><tt>GETFILENAME</tt> – file name and extension (<tt>text.txt</tt>).</p></li>
<li><p><tt>GETFILENAMENOEXT</tt> – file name and no extension (<tt>text</tt>).</p></li>
<li><p><tt>GETFILEEXT</tt> – file extension (from the dot to the end, e.g. <tt>txt</tt>).</p></li>
<li><p><tt>GETFILESIZE</tt> – file or directory size. By default, the appearance will depend on the option chosen in the <a href="#ConfigView">Files views</a> section, but all possible size formats are also available.</p></li>
<li><p><tt>GETFILETIME</tt> – file or directory modification date.</p></li>
<li><p><tt>GETFILECREATIONTIME</tt> – file or directory creation date.</p></li>
<li><p><tt>GETFILELASTACCESSTIME</tt> – file or directory last access date.</p></li>
<li><p><tt>GETFILECHANGETIME</tt> – file or directory status change date.</p></li>
<li><p><tt>GETFILEATTR</tt> – file or directory attributes. You can choose a string or numeric (octal) value. In Windows, an octal value can be used if Unix attributes are displayed in the file panel (for example, with the FTP plugin). For a detailed description of the string value, see <a href="#ConfigColorFiles">here</a>.</p></li>
<li><p><tt>GETFILEPATH</tt> – path to the current item. Uses: usually, for search results.</p></li>
<li><p><tt>GETFILEGROUP</tt> – displays the group of the file owner.</p></li>
<li><p><tt>GETFILEOWNER</tt> – displays the owner of the file.</p></li>
<li><p><tt>GETFILELINKTO</tt> – displays the path and file, that is, what is linked with this symlink.</p></li>
<li><p><tt>GETFILETYPE</tt> – file type (as in Windows Explorer or MIME-type).</p></li>
<li><p><tt>GETFILECOMMENT</tt> – file or directory description (comment) from <tt>descript.ion</tt> (see details <a href="help.html#cm_EditComment">here</a>).</p></li>
<li><p><tt>GETFILECOMPRESSEDSIZE</tt> – compressed file size (real size if using NTFS compression).</p></li>
</ul>
<p>By default, fields with timestamps use the date and time format that was choosen in the <a href="#ConfigView">Files views</a> settings section. You can also specify your preferred format directly in the column inside the curly brackets, using the same <a href="#dt_format">date and time formatting characters</a>.</p>
<p><span class="italic">Move</span> – allows to move lines (which equates to reordering the columns). Click twice in the Move box and you will see a type of spinner appear, clicking on the upper part moves the line up (column moves left).</p>
<p><span class="italic">Delete</span> – allows to remove any line. To delete: click in the Delete box of the line. Then click again, this time a delete symbol appears. If you click a third time the line will be deleted from the table.</p>
<p>Next, you can change the appearance of the file panels.</p>
<p><span class="italic">Go to set default</span> – opens the section <a href="#ConfigColorPanels">Colors > File panels</a>.</p>
<p><span class="italic">Use custom font and color for this view</span> – allows to change the appearance of file panels only for this set of columns (and separately for each column, if needed). You can override the font for the file panels and the global settings from <a href="#ConfigColorPanels">Colors > File panels</a>:</p>
<p class="figure"><img class="largeimage" title="Custom font and color" alt="Custom font and color" src="images/imgDC/pic38.png" width="884" height="300"></p>
<p>Note: <span class="italic">Cursor border</span> and <span class="italic">Use Frame Cursor</span> can be applied only for the whole set.</p>
<p><span class="italic">Previous</span>, <span class="italic">Next</span> – switches columns.</p>
<p><span class="italic">Customize column</span> – shows the name of the custom column.</p>
<p><span class="italic">>></span> – button for choosing any color from the palette.</p>
<p><span class="italic">R</span> – restores default value.</p>
<p><span class="italic">All</span> – applies the modification to all the other columns.</p>
<br>
<p><span class="bold"><a name="ConfigPlugins">2.9. Plugins</a></span></p>
<p>Plugins are extensions that enhance the functionality of Double Commander.</p>
<p>In the beginning, a few general settings.</p>
<p class="figure"><img class="largeimage" title="Plugins" alt="Plugins" src="images/imgDC/pic66.png" width="578" height="204"></p>
<p><span class="italic">When adding a new plugin, automatically go in tweak window</span> – See the description of the <span class="italic">Tweak</span> button below.</p>
<p><span class="italic">Plugin filename style when adding a new plugin</span> – Here you can choose how the path will be set when adding plugins:</p>
<ul>
<li><p>With complete absolute path.</p></li>
<li><p>Path relative to <a href="variables.html#envvariables">%COMMANDER_PATH%</a>.</p></li>
<li><p>Relative to the specified path.</p></li>
</ul>
<p>Also you can apply the chosen way to the already added plugins.</p>
<p><span class="italic"><a name="luapathtolibrary">Lua library file to use</a></span> – the full name of the Lua library, or only the file name if the file is located in the program directory or system directories for libraries. This path may be relative to the Double Commander executable file. (Lua scripts can be used for automation and as content plugins, see more details <a href="lua.html">here</a>.)</p>
<p>There are several types of plugins:</p>
<p><span class="italic">1. Packer plugins (WCX)</span></p>
<p>Packer plugins are used to unpack specific types of files, usually archive formats. Some plugins also support creating new archives and modifying existing archives.<br>
There are plugins that allow to save a list of selected files or use batch processing: creating links,converting files, copying with specific conditions, etc.<br>
Order matters: when choosing an appropriate plugin, Double Commander starts checking by extension from top to bottom. Use the <span class="italic">By extension/By plugin</span> button to switch list view and drag and drop.</p>
<p><span class="italic">2. Content plugins (WDX)</span></p>
<p>Content plugins are designed to get properties of a file or information about its content (for example, EXIF or ID3 tags). You can use this data in the file search or multi-rename tool, column set, tooltips.<br>
Also Double Commander supports content plugins written in the Lua language (scripts are added in the same way as ordinary plugins). Examples can be found in the program folder (<tt>plugins/wdx/scripts</tt>).</p>
<p><span class="italic">3. File system plugins (WFX)</span></p>
<p>File system plugins uses their own file systems or provides access to other file systems and devices (local or remote). For example, FTP servers, network directories, mobile devises. Also it can be lists of files, running processes and services, or the Windows registry.</p>
<p><span class="italic">4. Lister plugins (WLX)</span></p>
<p>The built-in viewer displays plain text files, some image formats and console commands output, plugins allow to expand this list: electronic documents and databases, audio and video files, font files, content of archives, detailed information about some files, source code files with syntax highlighting.<br>
Order matters: when choosing an appropriate plugin, Double Commander starts checking from top to bottom.</p>
<p><span class="italic">5. Search plugin (DSX)</span></p>
<p>Search plugins are Double Commander's own plugin type, these plugins use console programs to find files (for example, Locate, Everything or Recoll). The DSX plugins interface allows to send them <a href="findfiles.html">search parameter values</a> from the "Standard" and "Advanced" tabs. </p>
<p>Buttons:</p>
<ul>
<li><p><span class="italic">Add</span> – opens the file selection dialog. Alternatively, you can use the internal command <a href="cmds.html#cm_AddPlugin">cm_AddPlugin</a> (also plugins can be installed automatically).</p></li>
<li><p><span class="italic">Disable</span> – allows to temporarily disable the selected plugin.</p></li>
<li><p><span class="italic">Remove</span> – removes the selected plugin from the list (but not plugin file!).</p></li>
<li><p><span class="italic">Tweak</span> – the action depends on the type of plugin:</p>
<ul>
<li><p>WCX: change plugin path, set file extensions and supported functions;</p></li>
<li><p>WDX and WLX: change plugin path, display name or detect string;</p></li>
<li><p>WFX: change plugin path or display name.</p></li>
</ul>
</li>
<li><p><span class="italic">Configure</span> – opens the plugin's own settings window (if selected plugin supports this feature).</p></li>
</ul>
<p>Double Commander supports the use of a master password to protect passwords in WCX and WFX plugins (if the plugin developer has provided for the use of this feature). This is convenient because your passwords will be protected by encryption and you need to remember only one password. Passwords are encrypted twice, first using Blowfish (448 bits) and then using AES (256 bits).</p>
<p>Note: At the moment, Double Commander does not support changing the master password: if necessary, you will need to disable the use of the master password in the plugin settings, close the program, open the <a href="configuration.html#ConfigDC">directory with the configuration files</a>, delete the <tt>pwd.ini</tt> file, run the program again and enable the master password in the plugin settings. To delete outdated or unnecessary saved passwords, you will need to close the program and manually edit the <tt>pwd.ini</tt> file.</p>
<br>
<p><span class="bold"><a name="ConfigLayout">2.10. Layout</a></span></p>
<p class="figure"><img class="largeimage" title="Layout" alt="Layout" src="images/imgDC/pic39.png" width="438" height="462"></p>
<p>You can change the layout of the main window here. I suppose, all the available options are explained on the screenshot above (Layout). The screenshot below illustrates what DC looks like with all the layout options unselected.</p>
<p class="figure"><img class="largeimage" title="Layout DC" alt="Layout DC" src="images/imgDC/pic40.png" width="707" height="382"></p>
<br>
<p><span class="bold"><a name="ConfigDrivesList">2.10.1. Layout > Drives list button</a></span></p>
<p class="figure"><img class="largeimage" title="Drives list button" alt="Drives list button" src="images/imgDC/pic67.png" width="578" height="126"></p>
<p>In this section you can choose which additional information Double Commander will show in the <a href="help.html#iface_drive_btn">drives list menu</a>: drive label, file system and free space.</p>
<br>
<p><span class="bold"><a name="ConfigTreeMenu">2.10.2. Layout > Tree View Menu</a></span></p>
<p>In this section you can enable the Tree View Menu and choose where it will be used.</p>
<p class="figure"><img class="largeimage" title="Tree View Menu settings" alt="Tree View Menu settings" src="images/imgDC/pic68.png" width="578" height="433"></p>
<p>The Tree View Menu is a way to display some of the Double Commander menus as a tree in a separate window: Directory Hotlist, Favorite Tabs, directory and command line history. This way of presenting content and a filter will help you quickly select the desired menu item.</p>
<p class="figure"><img class="largeimage" title="Tree View Menu" alt="Tree View Menu" src="images/imgDC/pic41.png" width="412" height="384"></p>
<p>Using the parameters of the corresponding internal commands, you can set the position of the Tree View Menu:</p>
<ul>
<li><p>menu will be shown from the top left corner of active panel;</p></li>
<li><p>menu will be shown at the current mouse cursor position.</p></li>
</ul>
<p>Parameters can be specified in the <a href="#ConfigHotKeys">hotkey settings</a> or add a button on the <a href="toolbar.html">toolbar</a>.</p>
<p>Also Double Commander can display main menu and toolbar as a tree (always in the center of its window), see the description of commands <a href="cmds.html#cm_ShowMainMenu">cm_ShowMainMenu</a> and <a href="cmds.html#cm_ShowButtonMenu">cm_ShowButtonMenu</a>.</p>
<br>
<p><span class="bold"><a name="ConfigTreeMenuColor">2.10.3. Layout > Tree View Menu Colors</a></span></p>
<p>Here you can customize the appearance of the menu to your preference, a preview will show all changes before saving.</p>
<p class="figure"><img class="largeimage" title="Tree View Menu Colors" alt="Tree View Menu Colors" src="images/imgDC/pic69.png" width="688" height="457"></p>
<br>
<p><span class="bold"><a name="ConfigToolbar">2.11. Toolbar</a></span> and <span class="bold">Toolbar > Toolbar Middle</span></p>
<p>See the dedicated <a href="toolbar.html">Toolbar</a> help page about how to use and configure it.</p>
<br>
<p><span class="bold"><a name="ConfigToolbarEx">2.11.2. Toolbar > Toolbar Extra</a></span></p>
<p class="figure"><img class="largeimage" title="Toolbar Extra" alt="Toolbar Extra" src="images/imgDC/pic70.png" width="578" height="165"></p>
<p>In this section you can choose how the path will be set when adding icons, commands and starting paths:</p>
<ul>
<li><p>With complete absolute path.</p></li>
<li><p>Path relative to <a href="variables.html#envvariables">%COMMANDER_PATH%</a>.</p></li>
<li><p>Relative to the specified path.</p></li>
</ul>
<p>Also you can apply the chosen way to the already added paths.</p>
<br>
<p><span class="bold"><a name="ConfigOperations">2.12. File operations</a></span></p>
<p>This section contains settings related to file manipulation.</p>
<p class="figure"><img class="largeimage" title="File operations" alt="File operations" src="images/imgDC/pic71.png" width="578" height="526"></p>
<p><span class="italic">Show operations progress initially in</span> – sets the initial display way and position of the file operations progress:</p>
<ul>
<li><p>separate window;</p></li>
<li><p>minimized separate window;</p></li>
<li><p>operations panel: the special panel above the function key buttons bar will be used<br>
<img class="largeimage" title="Operations panel" alt="Operations panel" src="images/imgDC/pic42.png" width="320" height="100"><br>
(you can switch to display progress in a separate window by clicking on it with the mouse).</p></li>
</ul>
<p><span class="italic">Drop readonly flag</span> – If enabled, Double Commander will drop this flag in Windows, and add "w" attribute in Linux. This is handy if copying files from CD/DVD media where the files would retain the read-only attribute by default.</p>
<p><span class="italic">Select file name without extension when renaming</span> – If enabled, renaming with the <kbd>F2</kbd> key will select all characters in the file name up to the last dot, otherwise the entire file name will be selected.</p>
<p><span class="italic">Show tab select panel in copy/move dialog</span> – If the target panel has more than one tab, on copy/move you can choose the destination tab:</p>
<p class="figure"><img class="largeimage" title="Tabs in copy/move dialog" alt="Tabs in copy/move dialog" src="images/imgDC/pic43.png" width="534" height="298"></p>
<p><span class="italic">Delete to recycle bin (Shift key reverses this setting)</span> – If enabled, Double Commander will delete the selected files or the file under the cursor to trash (recycle bin) when you press <kbd>F8</kbd> or <kbd>Del</kbd> and will delete permanently when you use <kbd>Shift+F8</kbd> or <kbd>Shift+Del</kbd>. If unchecked, the behavior of this keys will be inverted.</p>
<p><span class="italic">Show confirmation window for</span> – allows to choose the file operations for which Double Commander will show confirmation dialogs. The maximum secure behavior is chosen by default. Keep in mind that this group of parameters is not taken into account when you use <a href="help.html#draganddrop">drag & drop</a>: in this case, Double Commander uses an independent parameter in the <a href="ConfigMouseDD">Mouse > Drag & drop</a> settings section.</p>
<p>The following parameters are directly related to the execution of operations.</p>
<p>The <span class="italic">Buffer size for file operations (in KB)</span> and <span class="italic">Buffer size for hash calculation (in KB)</span> parameters set the size of the allocated memory for operations such as copying, moving, splitting or combining files, searching for files by content and calculating checksums. You should keep in mind that there is no universal value, but you can try to find a more suitable size.<br>
Note: The first parameter is not used in the copy function in Windows, since the system function is used for copying.</p>
<p><span class="italic">Number of wipe passes</span> – Here you can specify the number of rewrites to <a href="help.html#cm_Wipe">secure delete files</a>.</p>
<p><span class="italic">Process comments with files/folders</span> – If enabled and you have a file/folder with a <a href="help.html#cm_EditComment">comment</a> attached and you copy or move it to another folder the comment will be copied or moved to the destination along with the file/folder.</p>
<p><span class="italic">Skip file operations errors and write them to log window</span> – If a file operation error should occur the error message will appear in the log window below the panels rather than appearing in a popup dialog. This can be useful because the error window will suspend the operation. In the <a href="#ConfigLog">Log</a> settings section, you can limit the total number of messages, allowing only messages with the "Error" status.<br>
The parameter is taken into account in most file operations: copying, moving, deleting, erasing, combining and splitting files, setting file properties (timestamps, owner, attributes), calculating checksum, as well as file operations when working with archives, WFX plugins and GVfs.</p>
<p><span class="italic">Duplicated name auto-rename style</span> – sets the file auto-renaming template if a file with the same name already exists in the target directory (i.e. when you choose <span class="italic">Auto-rename source files</span> or <span class="italic">Auto-rename target files</span> in the copy/move dialog): "Copy (x) filename.ext", "filename (x).ext" or "filename(x).ext", where "x" is a counter (2, 3, 4 and so on).</p>
<br>
<p><span class="bold"><a name="ConfigSearch">2.12.1. File operations > File search</a></span></p>
<p>See description on the <a href="findfiles.html#configuration">Find files</a> help page.</p>
<br>
<p><span class="bold"><a name="ConfigRename">2.12.2. File operations > Multi-Rename</a></span></p>
<p>See description on the <a href="multirename.html#configuration">Multi-Rename Tool</a> help page.</p>
<br>
<p><span class="bold"><a name="ConfigTabs">2.13. Folder tabs</a></span></p>
<p class="figure"><img class="largeimage" title="Folder tabs" alt="Folder tabs" src="images/imgDC/pic72.png" width="578" height="440"></p>
<p><span class="italic">Show tab header also when there is only one tab</span> – If this option is disabled and there is only one tab on the panel, a tab header won't appear (usually this is more visually attractive).</p>
<p><span class="italic">Tabs on multiple lines</span> (Windows only) – If the folder tabs do not fit in one line, then they will be placed in several lines. Otherwise, buttons to scroll them will be shown on the right (GTK2: on the right and left).</p>
<p><span class="italic">Limit tab title length to</span> – Tabs with long names will be limited to this length and the displayed name will be truncated if longer than this value.</p>
<p><span class="italic">Confirm close locked tabs</span> – If enabled then it will prompt for confirmation that you wish to close locked tab. Otherwise, such a tab will be closed as usual tab.</p>
<p><span class="italic"><a name="5_1_11_0_vopros">Confirm close all tabs</a></span> – If selected and a <a href="help.html#cm_CloseAllTabs">Close All Tabs</a> command is executed this option will prompt for confirmation that you wish to remove all inactive tabs.</p>
<p><span class="italic">Close duplicate tabs when closing application</span> – If enabled, Double Commander will check the list of opened tabs and close duplicate tabs (separately for each panel!), only the first of them will be saved (counting from the left).</p>
<p><span class="italic"><a name="5_1_11_2_vopros">Ctrl+Up opens new tab in foreground</a></span> – this option changes the behavior of the command <a href="help.html#cm_OpenDirInNewTab">Open folder in new tab</a> (<tt>cm_OpenDirInNewTab</tt>): if enabled then Double Commander will open a new tab for the directory under the cursor and will switches to this tab.</p>
<p><span class="italic">Open new tabs near current tab</span> – If enabled, new tab will be created on the right next to the currently active tab. If not, new tabs will be added to the right after the last tab.</p>
<p><span class="italic">Reuse existing tab when possible</span> – For locked tab with directory change in new tab: if the selected folder is already open on any tab, then this tab will be activated instead of creating a new tab.</p>
<p><span class="italic"><a name="5_1_11_3_vopros">Show tab close button</a></span> (Unix-like systems only) – If selected, a small "x" button will appear on tabs allowing to click on it to close them.</p>
<p><span class="italic"><a name="5_1_12_1_zvezda">Show locked tabs with an asterisk *</a></span> – to distinguish between locked and unlocked tabs. Locked tabs will be marked by "*". Tab <tt>Downloads</tt> is locked:</p>
<p class="figure"><img class="largeimage" title="Tabs" alt="Tabs" src="images/imgDC/pic6.png" width="228" height="28"></p>
<p><span class="italic">Keep renamed name when unlocking a tab</span> – When you change the state of a tab from "locked tab" on "normal tab", Double Commander returns the usual tab name (current folder name): this option allows to keep the changed name.</p>
<p><span class="italic">Activate target panel when clicking on one of its Tabs</span> – If enabled, when you click the mouse on a tab on the other panel, the focus will automatically be transferred to it (it will become the active panel). Also the cursor position will be retained when switching between panels this way.</p>
<p><span class="italic">Always show drive letter in tab title</span> (Windows only) – Show drive letter and a colon before the folder name, e.g. "c:plugins".</p>
<p><span class="italic">Tabs position</span> – Place folder tabs at the top or bottom of file panels.</p>
<p><span class="italic">Action to do when double click on a tab:</span> – You can choose one of the following actions:</p>
<ul>
<li><p>do nothing;</p></li>
<li><p>close this tab;</p></li>
<li><p>access Favorite Tabs (save current tabs, load saved set or configure);</p></li>
<li><p>show the tabs popup menu with the same items as in the <a href="help.html#mnu_tabs">"Tabs"</a> menu.</p></li>
</ul>
<br>
<p><span class="bold"><a name="ConfigFavoriteTabs">2.13.1. Folder tabs > Favorite Tabs</a></span></p>
<p>The list of saved tab sets is available in the <a href="help.html#mnu_fav">"Favorites"</a> menu and in the popup menu called by the <a href="cmds.html#cm_LoadFavoriteTabs">cm_LoadFavoriteTabs</a> command.</p>
<p>In this section you can manage them: change order, names, delete unnecessary, sort or group in a submenu.</p>
<p class="figure"><img class="largeimage" title="Favorite Tabs" alt="Favorite Tabs" src="images/imgDC/pic73.png" width="578" height="440"></p>
<p>Also you can export entries to the selected directory and import them. Each entries will be saved to a separate .tab file (if it necessary, tabs from such a file can be loaded using the <a href="cmds.html#cm_LoadTabs">cm_LoadTabs</a> command).</p>
<p>Some typical actions are added in the context menu of entries.</p>
<br>
<p><span class="bold"><a name="ConfigTabsEx">2.13.2. Folder tabs > Folder tabs extra</a></span></p>
<p>This section contains additional settings for Favorite Tabs.</p>
<p class="figure"><img class="largeimage" title="Folder tabs extra" alt="Folder tabs extra" src="images/imgDC/pic74.png" width="578" height="377"></p>
<p><span class="italic">Enable Favorite Tabs extra options (select target side when restore, etc.)</span> – By default, saved tabs will be restored in the same panel and they will replace all opened tabs, you can change it with:</p>
<ul>
<li><p><span class="italic">Tabs saved on left will be restored to:</span></p></li>
<li><p><span class="italic">Tabs saved on right will be restored to:</span></p></li>
<li><p><span class="italic">When restoring tab, existing tabs to keep:</span> – i.e. the Favorite Tabs will be added to the already open tabs.</p></li>
</ul>
<p>The following values are available for each parameter: <span class="italic">Left</span>, <span class="italic">Right</span>, <span class="italic">Active</span>, <span class="italic">Inactive</span>, <span class="italic">Both</span> or <span class="italic">None</span>.</p>
<p><span class="italic">Keep saving dir history with Favorite Tabs</span> – enables or disables saving the history of visited directories for each tab.</p>
<p>Also you can apply these parameters separately for each tabs set.</p>
<p><span class="italic">Default position in menu when saving a new Favorite Tabs</span> – determines the order of adding a new set:</p>
<ul>
<li><p>Add at beginning</p></li>
<li><p>Add at the end.</p></li>
<li><p>Alphabetical order.</p></li>
</ul>
<p>You can also choose to automatically open the <a href="#ConfigFavoriteTabs">Favorite Tabs</a> settings section after saving a new or resaving the current set:</p>
<ul>
<li><p><span class="italic">Goto to Favorite Tabs Configuration after saving a new one</span>.</p></li>
<li><p><span class="italic">Goto to Favorite Tabs Configuration after resaving</span>.</p></li>
</ul>
<br>
<p><span class="bold"><a name="ConfigLog">2.14. Log</a></span></p>
<p>Here you can choose the filename to log Double Commander's operations (copying or moving files, creating directories, launching external applications and so on). Also you can choose which operations will be logged.</p>
<p class="figure"><img class="largeimage" title="Log" alt="Log" src="images/imgDC/pic44.png" width="578" height="407"></p>
<p>If <span class="italic">Include date in log filename</span> is enabled, Double Commander will create a separate file for each day. In this case, you can set the number of log files: older files will be deleted automatically.</p>
<br>
<p><span class="bold"><a name="ConfigDC">2.15. Configuration</a></span></p>
<p class="figure"><img class="largeimage" title="Configuration" alt="Configuration" src="images/imgDC/pic75.png" width="712" height="562"></p>
<p><span class="italic">Location of configuration files</span> – Here you can choose where to store all configuration files (also you can see the full path here):</p>
<ul>
<li><p>The "settings" folder in the program directory (portable version).</p></li>
<li><p>User home directory.</p></li>
</ul>
<p>As an indicator, Double Commander uses an empty <tt>doublecmd.inf</tt> file in the "settings" folder in the program directory:
if the file exists, Double Commander will load configuration files from the "settings" folder and save them here, otherwise Double Commander will use the current user's folder.
You can manually add the <tt>doublecmd.inf</tt> file and get a portable version, or delete it by switching the storage method to the user's folder.</p>
<p>If you launch Double Commander with the <a href="commandline.html">--config-dir</a> parameter, then DC will just write <span class="italic">Set on command line</span> and show the full path to the configuration files.</p>
<p>To quickly navigate to the directory with configuration files, you can use the <span class="italic">Special Dirs</span> submenu in the <a href="directoryhotlist.html">Directory Hotlist</a> menu or use the <a href="variables.html#envvariables">%DC_CONFIG_PATH%</a> variable.</p>
<p>Buttons <span class="italic">Edit</span> and <span class="italic">Apply</span> – allow to open the <tt>doublecmd.xml</tt> configuration file and change the settings manually. Keep in mind that some settings require a restart of Double Commander to apply.</p>
<p>Note (or little trick): This way allows to apply settings immediately without restarting the DC (but not all!): for example, you can change and immediately apply the size of the icons in the file panels, but you will not be able to change the program language without restarting.</p>
<p><span class="italic">Save on exit</span> – Here you can choose what Double Commander will save on exit. Checkbox <span class="italic">Save configuration</span> enables or disables saving:</p>
<ul>
<li><p><span class="italic">Main window state</span> – Size and position of the application window.</p></li>
<li><p><span class="italic">Folder tabs</span> – List of tabs that are open in the left and right panels.</p></li>
<li><p><span class="italic">Search/Replace history</span> – <a href="findfiles.html">File search</a> history (except for file name masks, see below), history of masks in the <a href="multirename.html">Multi-Rename Tool</a> and history of searching and replacing text: search by file contents, viewer, built-in editor and built-in differ, search and replace in directory hotlist and toolbar settings. The state of the text search options (<span class="italic">Case sensitive</span>, <span class="italic">Regular expressions</span> and <span class="italic">Hexadecimal</span>) for each entry is also saved.</p></li>
<li><p><span class="italic">Directory history</span> – List of all visited directories (see note below).</p></li>
<li><p><span class="italic">Command line history</span> – Commands that were used at the <a href="help.html#iface_path">command line</a>.</p></li>
<li><p><span class="italic">File mask history</span> – Double Commander saves a general history of used file masks for several tools: find files, filters in <a href="syncdirs.html">directory synchronization</a> and <a href="help.html#cm_ExtractFiles">archive unpacking</a>, commands for <a href="help.html#cm_MarkPlus">selecting and deselecting a group of files</a>.</p></li>
</ul>
<p>The maximum number of entries in history is limited to 50.</p>
<p>Note about the history of visited directories: During the session, Double Commander stores up to 255 visited directories in memory (however, when the program is closed, only the last 50 entries will be saved). You can change the number of history entries in the popup menu when calling the <a href="cmds.html#cm_DirHistory">cm_DirHistory</a> command (default value is 30, see the <code>Count</code> attribute in the <a href="configxml.html"><DirHistory></a> tag), but when using the <a href="#ConfigTreeMenu">Tree View Menu</a>, all available history will be shown.</p>
<p>Note: Search templates are not related to the history and are saved separately (in the <tt>doublecmd.xml</tt> configuration file). To manage the list of templates, you can use the <a href="findfiles.html#templates">file search</a> tool.</p>
<p>You can choose how the list of settings sections will look:</p>
<ul>
<li><p><span class="italic">Sort order of configuration order in left tree</span> – You can choose classic (as in the source code of Double Commander and help) or alphabetical. In both cases, the <span class="bold">Language</span> section will be the first.</p></li>
<li><p><span class="italic">Tree state when entering in configuration page</span> – expand the whole tree or collapse.</p></li>
</ul>
<p><span class="italic">Directories</span> – Here you can see a list of directories that Double Commander can use to store thumbnail cache, icon themes and syntax highlighting files for the internal editor. You cannot change them, it's just information.<br>
If portable mode is used, Double Commander will only use the corresponding folders ("cache", "pixmaps" and "highlighters") in the program directory. Also in this mode, the "plugins" folder in the program directory will be used for automatic installation of plugins (see details <a href="cmds.html#cm_AddPlugin">here</a>).</p>
<br>
<p><span class="bold"><a name="ConfigQuick">2.16. Quick search/filter</a></span></p>
<p>This section contains the settings of the <a href="help.html#cm_QuickSearch">quick search/filter</a> tool. Quick search is used in searching for filenames in the panel, quick filter will hide all filenames that do not match the conditions.</p>
<p class="figure"><img class="largeimage" title="Quick search/filter" alt="Quick search/filter" src="images/imgDC/pic45.png" width="578" height="332"></p>
<p>Exact name match:</p>
<ul>
<li><p><span class="italic">Beginning (name must start with first typed character)</span> – means that the typed text will match the "text*" mask, where "*" is any number of any characters.</p></li>
<li><p><span class="italic">Ending (last character before a typed dot . must match)</span> – If there is a dot among the typed characters, the name must end with those characters. For example, if you typed "dx.l", the file mask will be "*dx.l*".</p></li>
</ul>
<p>If nothing is checked, the typed characters can be located in any part of the file name.</p>
<p>I like to have the <span class="italic">Beginning (name must start with first typed character)</span> selected and then I can just type the first character of the filename I'm looking for and then the second character, etc. The file is quickly located in this manner.</p>
<p>Below you can set the case sensitivity and choose what you want to search: only files or directories, or both.</p>
<p>These options can be changed on the fly directly in the quick search/filter bar. Also you can toggle between search and filter.</p>
<p>Options:</p>
<ul>
<li><p><span class="italic">Hide filter panel when not focused</span> – The quick search/filter panel will hide automatically as soon as you move the focus to the file panel. In <a href="help.html#iface_files">brief view</a> hiding the panel does not work correctly, so the option is ignored until a suitable solution is found.</p></li>
<li><p><span class="italic">Keep saving setting modifications for next session</span> – By default, all parameters that have been changed in the quick search panel will be kept in memory only until the program is closed, the option allows to change this behavior.</p></li>
</ul>
<br>
<p><span class="bold"><a name="ConfigMisc">2.17. Miscellaneous</a></span></p>
<p>This section contains parameters for which there was no suitable place in other sections of the settings:</p>
<p class="figure"><img class="largeimage" title="Miscellaneous" alt="Miscellaneous" src="images/imgDC/pic46.png" width="578" height="514"></p>
<p><span class="italic">Show splash screen</span> – If enabled, before displaying the main window, Double Commander will show a splash screen containing the program icon and version, compilation date, and the version of Lazarus, FPC, and operating system.</p>
<p><span class="italic">Show warning messages ("OK" button only)</span> – shows warning messages if enabled. (For example, if Double Commander cannot set some property or attribute of a file due to file system restrictions in the target directory.)</p>
<p><span class="italic">Always go to the root of a drive when changing drives</span> – If unchecked, Double Commander will go to the last open directory on this drive (in this case, you can go to the root directory of the drive by pressing its button twice).</p>
<p><span class="italic">Show current directory in the main window title bar</span> – If enabled, Double Commander will display the name of the current folder and the active panel path in the main window title bar.</p>
<p><span class="italic">Default single-byte text encoding:</span> – By default (NONE), the built-in file viewer and the built-in editor use automatic encoding detection, but you can specify one of the supported single-byte encodings as the default value. This parameter does not affect the automatic detection of multibyte encodings (UTF-8, UTF-16 and others). Special values are also available:</p>
<ul>
<li><p><span class="italic">ANSI</span> – default system ANSI encoding (depends on the system locale).</p></li>
<li><p><span class="italic">OEM</span> – default system OEM (DOS) encoding (depends on the system locale).</p></li>
</ul>
<p><span class="italic">Thumbnails</span> – Here you can set the thumbnail size of the images and enable saving the thumbnail cache (otherwise, the thumbnail cache will be stored in memory only until the program is closed). The parameter values are used in the corresponding <a href="help.html#iface_files">file list view mode</a> and in the built-in <a href="viewer.html#preview">viewer</a>. The thumbnail cache directory can be found in the <a href="#ConfigDC">Configuration</a> section. Double Commander uses PNG or JPEG (only for .bmp, .jpg and .jpeg) formats. The thumbnail name is the MD5 sum of the full name of the source file. The full name of the source file, its size and modification date will be added to the file.</p>
<p>The <span class="italic">Remove thumbnails for no longer existing files</span> button will help to remove obsolete thumbnails.</p>
<p><span class="italic">File comments (descript.ion)</span> – Here you can set the default encoding for existing <a href="help.html#cm_EditComment">file comments</a> (OEM, ANSI or UTF-8) and the encoding for new files (UTF-8 BOM, UTF-16 LE or UTF-16 BE).</p>
<p>The next group of parameters is used for import from Total Commander and export <a href="directoryhotlist.html#exportimporttc">Directory Hotlist</a> and <a href="toolbar.html">toolbar</a>: the path and name of the Total Commander executable file and the main configuration file, as well as the directory where the toolbar files are located.</p>
<br>
<p><span class="bold"><a name="ConfigRefresh">2.18. Auto refresh</a></span></p>
<p>Allows Double Commander to refresh panels automatically, same as the <kbd>Ctrl+R</kbd> manual refresh command does.</p>
<p class="figure"><img class="largeimage" title="Auto refresh" alt="Auto refresh" src="images/imgDC/pic76.png" width="578" height="217"></p>
<p><span class="italic">Refresh file list</span> – specifies what events Double Commander should react to and update the list of files and status bar:</p>
<ul>
<li><p>When files are created, deleted or renamed.</p></li>
<li><p>When size, date or attributes change.</p></li>
</ul>
<p>If it possible, Double Commander makes the appropriate change to the list of files, otherwise it completely rereads the list of files. If there are a large number of changes (if more than a quarter of the files are affected or the total number of changes exceeds 100), the list of files will be reread completely.</p>
<p>Note: This function may not work inside mounted network directories.</p>
<p>If both options are disabled, Double Commander will not watch changes made by third-party applications, and after changes made in the program in the file system, it will reread the entire list of files.</p>
<p>In virtual file systems (WFX plugins, GVfs), Double Commander rereads the entire list of files when you create, delete, or rename a file.</p>
<p>Note: Keep in mind that the final result may depend on the value of the <span class="italic">Insert new files</span> and <span class="italic">Move updated files</span> parameters in the <a href="#ConfigView">Files views</a> settings section.</p>
<p>Also you can disable auto-refresh:</p>
<ul>
<li><p>When Double Commander window is in the background or minimized.</p></li>
<li><p>For the specified paths and their subdirectories, just list them separated by semicolons ";" without spaces (e.g. <code>/home;/media/cdrom</code>).</p></li>
</ul>
<br>
<p><span class="bold"><a name="ConfigIcons">2.19. Icons</a></span></p>
<p class="figure"><img class="largeimage" title="Icons" alt="Icons" src="images/imgDC/pic77.png" width="578" height="558"></p>
<p>The first option enables the display of the file type icons to the left of the name:</p>
<ul>
<li><p><span class="italic">All associated + EXE/LNK (slow)</span> – Same as <span class="italic">All</span>, but additionally: icons from .exe, .ico, .cur, .ani and shortcuts (Windows), application icons from application catalogs (i.e. .app, macOS), .desktop and .directory (Linux and other Unix-like systems). Also DC will show the folder icon specified in the <tt>desktop.ini</tt> (Windows) and <tt>.directory</tt> (Linux) files.</p></li>
<li><p><span class="italic">All</span> – Icons for all file types associated with any program will be displayed (from system settings and Double Commander <a href="#ConfigAssociations">file associations</a>).</p></li>
<li><p><span class="italic">Only standard icons</span> – Only the icons listed in the <tt>pixmaps.txt</tt> file and the icons from the file association settings will be displayed. In this case, you can use icons only from the Double Commander icon theme (see directories <tt>pixmaps/dctheme/XxX/mimetypes</tt> in the program folder) or specify the full (with path) file name. Creating an icon theme is described in the <a href="faq.html#theme">FAQ</a>.</p></li>
<li><p><span class="italic">No icons</span>.</p></li>
</ul>
<p><span class="italic">Show overlay icons, e.g. for links</span> – If enabled, Double Commander will show overlay icons such as arrows for .lnk files and links.</p>
<p><span class="italic">Dimmed hidden files (slower)</span> – If enabled, Double Commander will show icons for hidden files with 50% transparency.</p>
<p><span class="italic">Disable special icons</span> – You can disable the loading of special icons (overlay icons, icons from .exe/.lnk files) for the specified directories and their subdirectories, just list them separated by semicolons ";" without spaces.</p>
<p><span class="italic">Icon size</span> – You can choose from the following sizes:</p>
<ul>
<li><p><span class="italic">File panel</span> – 16x16, 24x24, 32x32 or 48x48.</p></li>
<li><p><span class="italic">Disk panel</span> – 16x16, 24x24 or 32x32.</p></li>
<li><p><span class="italic">Main menu</span> – 16x16, 24x24 or 32x32.</p></li>
</ul>
<p><span class="italic">Show icons on buttons</span> – If enabled, Double Commander will show icons on the buttons of the dialog windows (<span class="italic">OK</span>, <span class="italic">Cancel</span>, <span class="italic">Start</span>, <span class="italic">Add To Queue</span> and so on).</p>
<p><span class="italic">Show icons for actions in menus</span> – If enabled, Double Commander will show icons in the main menu of the application window and the Multi-Rename Tool. This option also enables the display of a submenu icon in the Directory Hotlist and Favorite Tabs menus.</p>
<p>In the last parameter, <span class="italic">Icon theme</span>, you can choose an icon set from the drop-down menu. Double Commander does comes with one <span class="italic">DCTheme</span> icon theme, but you can create and add your own, see the <a href="faq.html#theme">FAQ</a> for details.</p>
<p>Note: In Unix-like systems, Double Commander will primarily use the system icon theme, if some icons does not exist, it will use its own.</p>
<br>
<p><span class="bold"><a name="ConfigIgnore">2.20. Ignore list</a></span></p>
<p>Ignore specific files and folders (one per line): they will not be displayed in panels.</p>
<p class="figure"><img class="largeimage" title="Ignore list" alt="Ignore list" src="images/imgDC/pic78.png" width="578" height="370"></p>
<ul>
<li><p>You can use full path to file or filename.</li>
<li><p>Supports the wildcards "*" and "?" (symbol "*" means match any number of characters, symbol "?" means any one character).</p></li>
<li><p>When a mask is ended with a directory separator, it will match only directories.</p></li>
</ul>
<p><span class="italic">Save in:</span> – the ignore list location (by default it's <tt>ignorelist.txt</tt> near <tt>doublecmd.xml</tt>).</p>
<p><span class="italic">Add selected names with full path</span> – will add all files/folders which selected in the active panel (if exists) or file under cursor with full path.</p>
<p><span class="italic">Add selected names</span> – will add names of all files/folders which selected in the active panel (if exists) or file under cursor. This means that they will be hidden everywhere.</p>
<p>Note: These two buttons will not add a directory separator to the end of the folder names.</p>
<p>You can use the internal command <a href="cmds.html#cm_SwitchIgnoreList">cm_SwitchIgnoreList</a> to turn this option on and off, add a button on toolbar or hotkey.</p>
<br>
<p><span class="bold"><a name="ConfigArchivers">2.21. Archivers</a></span></p>
<p>Please see the dedicated <a href="multiarc.html">Archive handling</a> help page about how to use and configure it.</p>
<br>
<p><span class="bold"><a name="ConfigTooltips">2.22. Tooltips</a></span></p>
<p>This section contains the settings for tooltips when the mouse cursor is hovering over a file.</p>
<p class="figure"><img class="largeimage" title="Tooltips" alt="Tooltips" src="images/imgDC/pic47.png" width="724" height="416"></p>
<p><span class="italic">Show tooltip for files in the file panel</span> – enables the ability to use tooltips.</p>
<p><span class="italic">File types</span> – contains a list of file groups. Double Commander checks the list from top to bottom until the first match: a file group higher in the list will overlap any file group below.</p>
<p>Buttons:</p>
<ul>
<li><p><span class="italic">Apply</span> – will save the settings for the selected file type.</p></li>
<li><p><span class="italic">Add</span> – will add a new file type and ask for a name, you may write a description of the file, what it does or what program it opens.</p></li>
<li><p><span class="italic">Copy</span> – will copy the selected file type with a new name.</p></li>
<li><p><span class="italic">Rename</span> – will prompt to enter a new name for the selected file type.</p></li>
<li><p><span class="italic">Delete</span> – will delete the selected file type.</p></li>
</ul>
<p>The <span class="italic">Other...</span> button is a menu:</p>
<ul>
<li><p><span class="italic">Discard Modifications</span> – will reset all unsaved changes in the selected file type.</p></li>
<li><p><span class="italic">Sort Tooltip File Types</span> – will sort the file types alphabetically (first upper then lower case).</p></li>
<li><p><span class="italic">Export...</span> and <span class="italic">Import...</span> – allow to export tooltips to a DC Tooltip file and import them from such files (in whole or in parts).</p></li>
</ul>
<p>Below you can configure the content of the tooltip for the selected file type.</p>
<p>In line <span class="italic">Category mask</span> put a wildcard mask to match file types (symbol "*" means match any number of characters, symbol "?" means any one character). You may put multiple file types here using a semicolon ";" without spaces. Also you can use search templates (<img title="Template..." alt="Template..." src="images/imgDC/btemplate.png" width="16" height="16">), including search with content plugins.</p>
<p>In the <span class="italic">Category hint</span> field, you can enter any text and use the WDX plugins fields to get information (the ">>" button).</p>
<p>The remaining parameters are general tooltip parameters.</p>
<p><span class="italic">Tooltip showing mode</span> – determines what type of tooltips Double Commander will show and how to combine them, if both types:</p>
<ul>
<li><p>Combine DC and system tooltip, DC first (legacy).</p></li>
<li><p>Combine DC and system tooltip, system first.</p></li>
<li><p>Show DC tooltip when possible and system when not.</p></li>
<li><p>Show DC tooltip only.</p></li>
<li><p>Show system tooltip only.</p></li>
</ul>
<p>The content of the system tooltip depends on the operating system:</p>
<ul>
<li><p>Windows: File name and the same as in Windows Explorer. If it was not possible to obtain information, then Double Commander will show the same as in Linux and other Unix-like systems.</p></li>
<li><p>Linux and other Unix-like systems: File name, modification date and size.</p></li>
</ul>
<p>The first line of the tooltip always contains the file name, and if you did not specify anything in the <span class="italic">Category hint</span> field, then the DC tooltip will contain only the file name.</p>
<p><span class="italic">Tooltip hiding delay</span> – sets the duration of displaying the tooltip: system default, 1 sec, 2 sec, 3 sec, 5 sec, 10 sec, 30 sec, 1 min and never hide (the tooltip will be hidden when you move the mouse cursor to another file or outside the file panel).</p>
<p>In the screenshot at the beginning of the section description, you can see an example of a tooltip with the <tt>textline.wdx</tt> plugin that shows the contents of the selected lines of a text file (in this case, the first, second and third lines), the <span class="italic">Combine DC and system tooltip, system first</span> mode is selected.</p>
<br>
<p><span class="bold"><a name="ConfigAssociations">2.23. File associations</a></span></p>
<p>This item opens the configuration file associations. All association sets are contained in the file <tt>extassoc.xml</tt>.</p>
<p>Here you can customize file associations and set commands or scripts for chosen file types. Commands will be added to the <a href="help.html#cm_ContextMenu">context menu</a> of files. Double Commander also allows to simply set (or replace) icons for file types, without adding any actions.</p>
<p class="figure"><img class="largeimage" title="File associations" alt="File associations" src="images/imgDC/pic48.png" width="578" height="538"></p>
<p><span class="italic">File types</span> – contains a list of extensions. Each group can contain many file extensions, and such a group can be associated with various programs.</p>
<p><span class="italic">Add</span> – adds a new group. You should enter a group name.</p>
<p><span class="italic">Remove</span> – deletes a group.</p>
<p><span class="italic">Rename</span> – allows to set a new name for the group.</p>
<p><span class="italic">Icon</span> – you can set the path to an icon for this group. Double Commander supports frequently used image formats, additionally in Windows you can use icons from binary executable files (.exe or .dll; in this case, DC will automatically choose the appropriate icon size from the available ones). You can also specify only the name of the icon without an extension (MIME-type icons are usually used), in this case:</p>
<ul>
<li><p>Windows: Double Commander will use the icon from its own current icon theme.</p></li>
<li><p>Linux and other Unix-like systems: Double Commander will use the icon from the system icon theme, because it has priority. If there is no icon file, the program will use the icon from its own current icon theme.</p></li>
</ul>
<p>This is a convenient way, because Double Commander will automatically choose the appropriate icon size from the available ones and will take into account the switching of the icon theme.</p>
<p><span class="italic">Extensions</span> – here you can set the extensions (without dot) for the selected group. You can add multiple extensions using a vertical bar "|" (without spaces between them). Special values:</p>
<ul>
<li><p><tt>file</tt> – any file;</p></li>
<li><p><tt>folder</tt> – any directory;</p></li>
<li><p><tt>default</tt> – used when extension specific association does not exists.</p></li>
</ul>
<p><span class="italic">Insert</span> – adds a new extension to the current position in the list.</p>
<p><span class="italic">Add</span> – adds a new extension to the end of the list.</p>
<p><span class="italic">Remove</span> – deletes an extension from the group.</p>
<p><span class="italic">Actions</span> – here you can set commands for the group.</p>
<p><span class="italic">Insert</span> – adds a new action to the current position in the list.</p>
<p><span class="italic">Add</span> – adds a new action to the end of the list.</p>
<p><span class="italic">Remove</span> – deletes an action from the list.</p>
<p><span class="italic">Up</span>, <span class="italic">Down</span> – moves the action. The actions (if more than one) can be reordered.</p>
<p><span class="italic">Action name:</span> – sets type of action. Variants:</p>
<ul>
<li><p>From popup menu</p>
<ul>
<li><p>Open – action will be run after pressing <kbd>Enter</kbd> or double click.</p></li>
<li><p>View – action will be run after pressing <kbd>F3</kbd>.</p></li>
<li><p>Edit – action will be run after pressing <kbd>F4</kbd>.</p></li>
</ul>
</li>
<li><p>Other actions displayed in the file context menu (submenu "Actions").</p></li>
</ul>
<p><span class="italic">Command</span> – any command from Desktop Environment. Several macros are also available (names are case sensitive!):</p>
<ul>
<li><p><tt>{!DC-EDITOR}</tt> – call internal editor;</p></li>
<li><p><tt>{!DC-VIEWER}</tt> – call internal viewer;</p></li>
<li><p><tt>{!EDITOR}</tt> – call editor (internal or external, depends on the configuration);</p></li>
<li><p><tt>{!VIEWER}</tt> – call viewer (internal or external, depends on the configuration);</p></li>
<li><p><tt>{!SHELL}</tt> – run in terminal and stay open at the end.</p></li>
<li><p><tt>{!TERMSTAYOPEN}</tt> – run in terminal and stay open at the end;</p></li>
<li><p><tt>{!TERMANDCLOSE}</tt> – run in terminal and request to close it at the end.</p></li>
</ul>
<p>"View" actions with the <tt>{!DC-VIEWER}</tt> macro will be taken into account for <a href="viewer.html#quick">quick viewing</a>, other macros and commands will be ignored.</p>
<p><tt>{!TERMSTAYOPEN}</tt> and <tt>{!TERMANDCLOSE}</tt> have been added for unification and the ability to use the variables <a href="variables.html#executeterm">%t0 and %t1</a>, <tt>{!SHELL}</tt> has been kept for backwards compatibility.</p>
<p>As a command, you can use the <a href="cmds.html">internal commands</a> of Double Commander. The parameters of the internal commands are specified one per line, so you can specify only one here. Also, using the internal command <a href="cmds.html#cm_ExecuteScript">cm_ExecuteScript</a>, you can run <a href="lua.html">Lua scripts</a>, in this case you can get the names of the selected files using internal commands (<a href="cmds.html#cm_CopyFullNamesToClip">cm_CopyFullNamesToClip</a> or <a href="cmds.html#cm_SaveSelectionToFile">cm_SaveSelectionToFile</a>) or the <a href="lua.html#dc_expandvar">DC.ExpandVar</a> function.</p>
<p><span class="italic">Parameters</span> – command parameters including variables:</p>
<ul>
<li><p>any variable from <a href="variables.html">"percent" variables</a>.</p></li>
<li><p><tt><?command?></tt> – runs "command" in the system shell and feeds the output to the command above.</p></li>
</ul>
<p>At a minimum, you must specify a file name, usually <code>%p</code> or <code>%p0</code> for the file under cursor.</p>
<p><span class="italic">Start path</span> – command start directory. This directory will become the working directory of the program being launched, and if you do not need to explicitly specify it, then just leave this field empty: in this case, the working directory will be the current directory of the active file panel (regular files) or the system directory for the temporary files (files from archives and WFX plugins). Here we can use the variable <a href="variables.html#pathpanel">%D</a>, <a href="variables.html#basicvar">%d</a> or <a href="variables.html#envvariables">environment variables</a>.</p>
<p>All available actions will be displayed in the "Actions" submenu in the context menu:</p>
<p class="figure"><img class="largeimage" title="Context menu" alt="Context menu" src="images/imgDC/pic49.png" width="460" height="288"></p>
<br>
<p><span class="bold"><a name="ConfigAssocEx">2.23.1. File associations > File associations extra</a></span></p>
<p class="figure"><img class="largeimage" title="File associations extra" alt="File associations extra" src="images/imgDC/pic79.png" width="578" height="366"></p>
<p><span class="italic">Offer to add selection to file association when not included already</span> – When accessing file association, offer to add current selected file if not already included in a configured file type. This is a quick way to add an "Open with" action: Double Commander will prompt you to specify a type name and an executable file, everything else will be done automatically.</p>
<p><span class="italic">Extended context menu</span> – allows to add some items to the "Actions" submenu:</p>
<ul>
<li><p><span class="italic">Default context actions (View/Edit)</span> – Commands for opening a file in the viewer and editor. Built-in tools or external applications will be used (depending on the settings), internal file associations will be ignored.</p></li>
<li><p>Run using macros <tt>{!SHELL}</tt>, <tt>{!TERMANDCLOSE}</tt> and <tt>{!TERMSTAYOPEN}</tt> (see details <a href="#ConfigAssociations">here</a>):</p>
<ul>
<li><p><span class="italic">Execute via shell</span></p></li>
<li><p><span class="italic">Execute via terminal and close</span></p></li>
<li><p><span class="italic">Execute via terminal and stay open</span></p></li>
</ul>
</li>
<li><p><span class="italic">File association configuration</span> – opens the <a href="#ConfigAssociations">File associations</a> settings section.</p></li>
</ul>
<p>Below you can choose how the path will be set when adding icons, commands and starting paths:</p>
<ul>
<li><p>With complete absolute path.</p></li>
<li><p>Path relative to <a href="variables.html#envvariables">%COMMANDER_PATH%</a>.</p></li>
<li><p>Relative to the specified path.</p></li>
</ul>
<p>Also you can apply the chosen way to the already added paths.</p>
<br>
<p><span class="bold"><a name="ConfigDirHotlist">2.24. Directory Hotlist</a></span></p>
<p>Please see the dedicated <a href="directoryhotlist.html">Directory Hotlist</a> help page about how to use and configure it.</p>
<br>
<p><span class="bold"><a name="ConfigDirHotlistEx">2.24.1. Directory Hotlist > Directory Hotlist Extra</a></span></p>
<p class="figure"><img class="largeimage" title="Directory Hotlist Extra" alt="Directory Hotlist Extra" src="images/imgDC/pic80.png" width="578" height="165"></p>
<p>In this section you can choose how the path will be set the path and target path:</p>
<ul>
<li><p>With complete absolute path.</p></li>
<li><p>Path relative to <a href="variables.html#envvariables">%COMMANDER_PATH%</a>.</p></li>
<li><p>Relative to the specified path.</p></li>
</ul>
<p>Also you can apply the chosen way to the already added paths.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
<div>
<br>
<p><small>Created by Rustem (dok_rust@bk.ru)</small></p>
<p><small>English version by Rod J (rodmac_shiels@hotmail.com)</small></p>
</div>
</div>
<div class="footer"><div class="nav"><a title="Index" href="index.html">Index</a> | <a title="Previous page" href="help.html">Previous</a> | <a title="Next page" href="shortcuts.html">Next</a></div></div>
<div class="checker">
<a href="https://validator.w3.org/check?uri=referer" target="_blank"><img src="https://www.w3.org/Icons/valid-html40" alt="Valid HTML 4.0 Transitional" height="31" width="88"></a>
<a href="https://jigsaw.w3.org/css-validator/check/referer" target="_blank"><img style="border:0;width:88px;height:31px" src="https://jigsaw.w3.org/css-validator/images/vcss" alt="CSS Valid!"></a>
</div>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
</body>
</html>
|
