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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>DC - doublecmd.xml</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="commandline.html">Previous</a> | <a title="Next page" href="plugins.html">Next</a></div></div>
<div class="dchelpage">
<div>
<h1>2.17. Settings in doublecmd.xml</h1>
</div>
<div>
<h2>Content</h2>
<dl>
<dt>1. <a href="#presenta">Presentation</a></dt>
<dt>2. <a href="#location">Location</a></dt>
<dt>3. <a href="#manualed">Options to change manually</a></dt>
<dt>4. <a href="#index">Index</a></dt>
</dl>
</div>
<div>
<h2><a name="presenta">1. Presentation</a></h2>
<p>Main settings of Double Commander are saved/restored to/from an <a href="https://en.wikipedia.org/wiki/XML" target="_blank">XML</a> file named <tt>doublecmd.xml</tt>.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
<div>
<h2><a name="location">2. Location</a></h2>
<p>The location of this <tt>doublecmd.xml</tt> file may be in different places:</p>
<ul>
<li>It may be configured to be in the user home directory.</li>
<li>It may be configured to be in the program directory itself, which is commonly the case when used in a portable context.</li>
<li>We may define its location via a command line parameter when launching the application.</li>
</ul>
<p>We follow <a href="commandline.html">this link</a> if we want to specify it by with the command line paramter <code>--config-dir</code>.</p>
<p>Other than that, we do Configuration > Options... > select in the tree <img src="images/imgDC/optionconfiguration.png" alt="Double Commander" width="100" height="20" border="1px"> > set the option <i>Location of configuration files</i>.</p>
<p class="figure"><img class="largeimage" title="Location of configuration file" alt="Location of configuration file" src="images/imgDC/configlocation.png" width="496" height="141"></p>
<p>Another way to quickly find out where is located the <tt>doublecmd.xml</tt> the current instance of Double Commander is using is by accessing the <a href="directoryhotlist.html">Directory Hotlist</a>. At the end of it there is a sub section called "Special Dirs". Then we select "Go to Double Commander special path" and then "%DC_CONFIG_PATH%". We will find there the <tt>doublecmd.xml</tt> that application is currently using.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
<div>
<h2><a name="manualed">3. Options to change manually</a></h2>
<p>The large majority of possible settings in Double Commander may be set via the application itself through the various option categories.</p>
<p>We simply click from the main menu bar Configuration > Options and the various settings we'll configured there will be saved to the <tt>doublecmd.xml</tt> file when we close the application. Then, they will be restored on the next usage of the application.</p>
<p><span class="uline">So generally, we don't have to manually edit the content of the configuration file</span>.</p>
<p>But there are some very rare specific settings that required to be edited manually from the configuration file if we want to tweak the application.</p>
<br>
<p><b>WARNING:</b> We will not edit that file WHILE Double Commander is running! Not only because anyway their values are read only when we're starting the application, but also because if we edited the file while DC is running, when we'll close the application the values we would have wrote will be overwritten by the application re-saving its current context for next session. If we need to edit the <tt>doublecmd.xml</tt> file, we need to make sure we close Double Commander, then we edit file, and then we re-launch the application.<br>
There is an alternative solution, see more details <a href="configuration.html#ConfigDC">here</a> (but to apply changes to some options, you may still need to restart the application).</p>
<br>
<p>The following table gives us these rare specific settings that we need to manually edit the file if we need to change them.</p>
<br>
<table>
<tr class="rowcategorytitle"><th colspan="2">Setting required to be changed manually if necessary</th></tr>
<tr class="rowsubtitle"><th class="namecolumn">Tag</th><th class="categorydesccolumn">Description</th></tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <AutoRefresh>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="Mode"><Mode></a></div></td>
<td class="hintcell">
The ability to delete watched directories.<br>A "watched directory" is a directory that Double Commander has a kind of hook on it so it can monitor any modification in it.<br>This way, it can refresh the displayable content of it if it's content changed.<br>
This setting allows to control how Double Commander will react if we attempt to delete one of these "watched directory" currently displayed in a panel, even in a non-activated tab.<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Value</th>
<th class="innerdescheader">Description</th>
</tr>
<tr>
<td class="innerdescvaluecell">0</td>
<td class="innerdescdesccell">Prevents deleting watched directories.</td>
</tr>
<tr>
<td class="innerdescvaluecell">1</td>
<td class="innerdescdesccell">Does not prevent deleting watched directories (default).</td>
</tr>
<tr>
<td class="innerdescvaluecell">2</td>
<td class="innerdescdesccell">Watch whole drives instead of single directories to omit problems with deleting watched directories.</td>
</tr>
</table>
<i>Example:</i> <code><Mode>1</Mode></code>
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <Behaviours>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="ActiveRight"><ActiveRight></a></div></td>
<td class="hintcell">
The right panel will be active when Double Commander starts.<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Value</th>
<th class="innerdescheader">Description</th>
</tr>
<tr>
<td class="innerdescvaluecell">True</td>
<td class="innerdescdesccell">Right panel</td>
</tr>
<tr>
<td class="innerdescvaluecell">False</td>
<td class="innerdescdesccell">Left panel (default)</td>
</tr>
</table>
<i>Example:</i> <code><ActiveRight>True</ActiveRight></code>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="ConfirmQuit"><ConfirmQuit></a></div></td>
<td class="hintcell">Confirm closing Double Commander (<code>True</code>) or not (<code>False</code>). <code>False</code> by default.</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <Colors>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="gBorderFrameWidth"><gBorderFrameWidth></a></div></td>
<td class="hintcell">
We may configure DC so it will draw a rectangle around the active entry as we we cycle through them in a panel.<br>
<code><gBorderFrameWidth></code> allows us to configure the width of the lines used to draw a rectangle around the current active entry.<br>
To view that rectangle, we should go in Configuration > Options... > Colors > File panels and check the option <i>Use frame cursor</i>.<br>
<i>Example:</i> <code><gBorderFrameWidth>1</gBorderFrameWidth></code>
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <Editor>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="FindWordAtCursor"><FindWordAtCursor></a></div></td>
<td class="hintcell">Internal editor and differ tool: if nothing is selected, the search and replace dialog will use the word under the cursor (<code>True</code>) or text from the search history (<code>False</code>). <code>True</code> by default.</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <FileOperations>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="AutoExtractOpenMask"><AutoExtractOpenMask></a></div></td>
<td class="hintcell">
Suppose we've "entered" into a compressed file and browsing its content in the active panel. The files with the specified extension of this setting will be automatically unpacked from the archive when we press <kbd>Enter</kbd> or double-click on them instead of showing the properties window.<br>
<i>Example:</i> <code><AutoExtractOpenMask>*.txt;*.mp3;*.mp4</AutoExtractOpenMask></code>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="DefaultDropEffect"><DefaultDropEffect></a></div></td>
<td class="hintcell">The default action when <a href="help.html#draganddrop">drag & drop files</a> with the mouse: copying (<code>True</code>) or moving (<code>False</code>) files. <code>True</code> by default.</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="LongNameAlert"><LongNameAlert></a></div></td>
<td class="hintcell">Warn if target path is longer than maximum length for a path (some programs will not be able to access a file/directory with such a long name). In Windows this value (MAX_PATH) is defined as 260 characters. <code>True</code> by default.</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="NtfsHourTimeDelay"><NtfsHourTimeDelay></a></div></td>
<td class="hintcell">
Ignore time difference of exactly one hour between entries when comparing their date and time.<br>
This takes place when using internal commands <a href="cmds.html#cm_CompareDirectories">cm_CompareDirectories</a> or <a href="cmds.html#cm_SyncDirs">cm_SyncDirs</a>.<br>
It is useful when comparing items located on a NTFS partition to another one not on such partition.<br>
Since the <a href="https://support.microsoft.com/en-us/help/129574/time-stamp-changes-with-daylight-savings" target="_blank">time stamp of a file changes on a NTFS partition</a> when daylight savings period occurs and not when the same exact file is from a FAT32, we want the two files to be consider identical even if we visibly see a one hour difference between the two.<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Value</th>
<th class="innerdescheader">Description</th>
</tr>
<tr>
<td class="innerdescvaluecell">True</td>
<td class="innerdescdesccell">Enable, a difference of exactly one hour will be considered the same time</td>
</tr>
<tr>
<td class="innerdescvaluecell">False</td>
<td class="innerdescdesccell">Disable (default)</td>
</tr>
</table>
<i>Example:</i> <code><NtfsHourTimeDelay>True</NtfsHourTimeDelay></code>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="Sounds"><Sounds></a></div></td>
<td class="hintcell">
Enables sound notifications when file operations are finished. Possible contents of the <code><Sounds></code> tag in full:<br>
<pre>
<Sounds Duration="-1">
<Copy>C:\Windows\Media\Alarm01.wav</Copy>
<Move>C:\Windows\Media\Alarm01.wav</Move>
<Wipe>C:\Windows\Media\Alarm01.wav</Wipe>
<Delete>C:\Windows\Media\Alarm01.wav</Delete>
<Split>C:\Windows\Media\Alarm01.wav</Split>
<Combine>C:\Windows\Media\Alarm01.wav</Combine>
</Sounds></pre>
<code>Duration</code> is the minimum time (in seconds) that a file operation should last. Additional values: 0 – always on, -1 disables sound notifications.<br>
File operations: copy, move, wipe, delete files, split file and combine files. If a sound notification is not needed for some operation, just remove (or do not add) the corresponding line. <a href="variables.html#envvariables">Environment variables</a> are supported.<br>
Supported audio formats:<br>
- Windows (the <tt>sndPlaySoundW</tt> function from the Windows API): .wav.<br>
- macOS (the Core Audio API): .aac, .adts, .ac3, .caf, .mp3, .m4a and .mp4 (with AAC or ALAC), .wav.<br>
- Linux and other Unix-like systems: Double Commander can use the GStreamer library (primarily, <tt>libgstreamer-1.0.so.0</tt>) or the SDL2 library (<tt>libSDL2-2.0.so.0</tt>). GStreamer supports most popular audio formats, with SDL2 we can use only .wav. In Haiku, only SDL2 can be used.
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <FileOperations><Options>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="CopyAttributes"><CopyAttributes></a></div></td>
<td class="hintcell">
Windows: if <code>True</code>, the attributes of the source file will be copied when copying/moving files; if <code>False</code>, the attributes of the source file will also be copied and Double Commander will set the "archive" attribute.<br>
Linux and others: use the <span class="italic">Copy attributes</span> option in the <a href="copymove.html">copy/move dialog window</a>.<br>
<code>True</code> by default.
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="CopyTime"><CopyTime></a></div></td>
<td class="hintcell">
Windows: if <code>True</code>, the timestamps of the source file will be copied (creation date, modification date, last access date) when copying/moving files, otherwise, only the modification date will be copied and the current date will be used for others.<br>
Linux and others: use the <span class="italic">Copy date/time</span> option in the <a href="copymove.html">copy/move dialog window</a>.<br>
<code>True</code> by default.
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="CopyXattributes"><CopyXattributes></a></div></td>
<td class="hintcell">
Copy filesystem extended attributes when copying/moving files or not.<br>
Windows: if <code>True</code>, compressed and encrypted attributes will also be copied.<br>
Linux and other Unix-like systems: if <code>True</code>, Double Commander will copy filesystem extended attributes (xattr, i.e. the named attributes).<br>
<code>True</code> by default.
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <FilesViews>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="ExtraLineSpanF"><ExtraLineSpan></a></div></td>
<td class="hintcell">
This setting allows to add some extra pixels to the height allowed for each element displayed in the file panels. The value is interpreted directly in pixels.<br>
Default value is 2.<br>
<i>Example:</i> <code><ExtraLineSpan>2</ExtraLineSpan></code>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="FolderPrePostfix"><FolderPrefix> <small>and</small> <FolderPostfix></a></div></td>
<td class="hintcell">
By default DC shows square brackets around directory names (it's optional parameter in Files views > Files views extra), but we can use any symbols instead them.<br>
Note: In XML some special symbols are reserved as part of markup and we can not use them as is. There are five predefined entities: <code><</code> should write as <code>&lt;</code>, <code>></code> as <code>&gt;</code>, <code>&</code> as <code>&amp;</code>, <code>'</code> as <code>&apos;</code> and <code>"</code> as <code>&quot;</code>.
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="RenameConfirmMouse"><RenameConfirmMouse></a></div></td>
<td class="hintcell">
This option changes the mouse click action when renaming a file under the cursor: if <code>True</code>, the mouse click outside the name edit field will confirm renaming the file (as in Windows Explorer), otherwise, the mouse click will work the same as the <kbd>Esc</kbd> key.<br>
<code>False</code> by default.<br>
In both cases, we can still use the button to the right of the edit field to confirm the operation.
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <FilesViews><ColumnsView>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="AutoSaveWidth"><AutoSaveWidth></a></div></td>
<td class="hintcell">
When we manually change the column width with the mouse help, by default DC changes it for both panels and saves a new value for the next launches.<br>
If we want to disable this behavior and use new value only in the current session, we should replace <code>True</code> with <code>False</code>, i.e. use <code><AutoSaveWidth>False</AutoSaveWidth></code>.
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="LongInStatus"><LongInStatus></a></div></td>
<td class="hintcell">If the columns view is set and there are no selected files, the status bar displays the file name under the cursor (<code>True</code>) or the number of files (<code>False</code>, by default).<br>
If <code>True</code>, the status bar will also show the number of files when the cursor is on the ".." item. For links, target objects will additionally be displayed.</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="TitleStyle"><TitleStyle></a></div></td>
<td class="hintcell">
Changes the look of tabstop headers bar.<br>Default value depends on your OS.<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Value</th>
<th class="innerdescheader">Description</th>
</tr>
<tr>
<td class="innerdescvaluecell">0</td>
<td class="innerdescdesccell"><b>tsLazarus</b>: The default Lazarus's look.</td>
</tr>
<tr>
<td class="innerdescvaluecell">1</td>
<td class="innerdescdesccell"><b>tsStandard</b>: A more contrasted look, like Delphi grids.</td>
</tr>
<tr>
<td class="innerdescvaluecell">2</td>
<td class="innerdescdesccell"><b>tsNative</b>: Tries to set a look that is in concordance with current widgetset theme.</td>
</tr>
</table>
<i>Example:</i> <code><TitleStyle>2</TitleStyle></code>
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from many tags <Fonts>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="Quality"><Quality></a></div></td>
<td class="hintcell">
Determine what type of <a href="https://en.wikipedia.org/wiki/Font_rasterization" target="_blank">font rasterization</a> that will be used. In other words, it determine the font quality.<br>
There are many tags where it's applicable individually.<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Value</th>
<th class="innerdescheader">Description</th>
</tr>
<tr>
<td class="innerdescvaluecell">0</td>
<td class="innerdescdesccell"><b>Default</b>: The quality is determined by the system settings (default).</td>
</tr>
<tr>
<td class="innerdescvaluecell">1</td>
<td class="innerdescdesccell"><b>Draft</b>: For raster fonts, scaling is enabled; the font size can be increased but the quality may be lower.<br>Also the font supports Bold, Italic, Underline or Strikeout if necessary.<br>The quality is less important than when Proof is used.</td>
</tr>
<tr>
<td class="innerdescvaluecell">2</td>
<td class="innerdescdesccell"><b>Proof</b>: The quality of the characters is important, so for the raster fonts, scaling is disabled and the font closest in size is chosen.</td>
</tr>
<tr>
<td class="innerdescvaluecell">3</td>
<td class="innerdescdesccell"><b>NonAntialiased</b>: The font is never antialiased.</td>
</tr>
<tr>
<td class="innerdescvaluecell">4</td>
<td class="innerdescdesccell"><b>Antialiased</b>: The font is always antialiased if it supports it.<br>The size of the font cannot be too small or too large.</td>
</tr>
<tr>
<td class="innerdescvaluecell">5</td>
<td class="innerdescdesccell"><b>ClearType</b>: The font is rendered using the <a href="https://en.wikipedia.org/wiki/ClearType" target="_blank">ClearType</a> anti-aliasing method.</td>
</tr>
<tr>
<td class="innerdescvaluecell">6</td>
<td class="innerdescdesccell"><b>ClearTypeNatural</b>: The font is rendered using the Natural ClearType antialiasing method.</td>
</tr>
</table>
<i>Example:</i> <code><Quality>1</Quality></code>
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <History>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="Count">Attribute <i>Count</i><br><small>from <History><DirHistory></small></a></div></td>
<td class="hintcell">
The <code>Count</code> attribute allows to specify the number of entries from the list of visited directories that will be displayed in the popup menu (the <a href="cmds.html#cm_DirHistory">cm_DirHistory</a> command). Default value is 30.<br>
When using the Tree View Menu, the attribute value will be ignored.
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <Icons>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="CustomIcons"><CustomIcons></a></div></td>
<td class="hintcell">
This option will help to determine if the icons used for drives, folders or archives will be the default ones from the system or if it will be custom ones that we may set ourselves.<br>
The <code>CustomIcons</code> option will be set to a single number representing the sum of the numbers from the following table depending on what are our preferences:<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Element</th>
<th class="innerdescheader">From system</th>
<th class="innerdescheader">Custom</th>
</tr>
<tr>
<td class="innerdescvaluecell">Drives</td>
<td class="innerdescdesccell">0</td>
<td class="innerdescdesccell">1 (Windows only)</td>
</tr>
<tr>
<td class="innerdescvaluecell">Folders</td>
<td class="innerdescdesccell">0</td>
<td class="innerdescdesccell">2 (all except Haiku)</td>
</tr>
<tr>
<td class="innerdescvaluecell">Archives</td>
<td class="innerdescdesccell">0</td>
<td class="innerdescdesccell">4 (Windows, Linux and FreeBSD)</td>
</tr>
</table>
<br>
<i>
If we want...<br>
...everything from the system: 0 + 0 + 0= 0 so <code><CustomIcons>0</CustomIcons></code><br>
...everything custom: 1 + 2 + 4 = 7 so <code><CustomIcons>7</CustomIcons></code><br>
...drive custom, other system: 1 + 0 + 0 = 1 so <code><CustomIcons>1</CustomIcons></code><br>
etc...
</i>
<br><br>
If we wish to use custom icons, here is the location for each items:<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Element</th>
<th class="innerdescheader">Location</th>
</tr>
<tr>
<td class="innerdescvaluecell">Drives</td>
<td class="innerdescdesccell">%commander_path%\pixmaps\theme\XxX\devices\</td>
</tr>
<tr>
<td class="innerdescvaluecell">Folders</td>
<td class="innerdescdesccell">%commander_path%\pixmaps\theme\XxX\places\folder.png</td>
</tr>
<tr>
<td class="innerdescvaluecell">Archives</td>
<td class="innerdescdesccell"><small>%commander_path%\pixmaps\theme\XxX\mimetypes\package-x-generic.png</small></td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="DiskAlpha"><DiskAlpha></a></div></td>
<td class="hintcell">
Option to set the transparency level of unmounted drive icons.<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Value</th>
<th class="innerdescheader">Description</th>
</tr>
<tr>
<td class="innerdescvaluecell">1 to 99</td>
<td class="innerdescdesccell">Valid transparency level (default is 50).</td>
</tr>
<tr>
<td class="innerdescvaluecell">0 or 100</td>
<td class="innerdescdesccell">Disables function.</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="ToolSize"><ToolSize></a></div></td>
<td class="hintcell">Size of toolbar icons in the internal editor, viewer and differ tool, supported values: 16, 24 or 32.</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <Layout>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="ShowColonAfterDrive"><ShowColonAfterDrive></a></div></td>
<td class="hintcell">Windows only: show colon after letters of disks in the <a href="help.html#iface_drive_pane">drives button bar</a> and in the <a href="help.html#iface_drive_btn">drives list</a>. <code>False</code> by default.</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="UppercaseDriveLetter"><UppercaseDriveLetter></a></div></td>
<td class="hintcell">
Windows only: use uppercase letters in the <a href="help.html#iface_drive_pane">drives button bar</a> and in the <a href="help.html#iface_drive_btn">drives list</a>. <code>False</code> by default.<br>
Note: This option does not change drive letters in previously saved history and settings (favorites, buttons and so on).
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <Miscellaneous>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="DecimalSeparator"><DecimalSeparator></a></div></td>
<td class="hintcell">The option allows to specify the preferred decimal separator character (i.e. separator for integer and fractional parts of a number) instead of the value from your regional settings. We can specify any character from the ASCII table with a code from U+0000 to U+007F (the use of printable characters is implied, i.e. from U+0020 to U+007E).</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="DoubleClickEditPath"><DoubleClickEditPath></a></div></td>
<td class="hintcell">The option allows to choose the action of double-clicking on the the <a href="help.html#iface_dir">current directory bar</a>: show directory hotlist (<code>False</code>, by default) or edit current path (<code>True</code>).</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="SystemItemProperties"><SystemItemProperties></a></div></td>
<td class="hintcell">Linux/FreeBSD: the <code>True</code> value allows to use the file properties dialog window of the file manager, which is specified as the default program in the desktop environment settings (if it possible), otherwise, Double Commander will use its own <a href="help.html#cm_FileProperties">properties window</a>. <code>False</code> by default.</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <SyncDirs>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="DateTimeFormat"><DateTimeFormat></a></div></td>
<td class="hintcell">This setting allows to specify the preferred date and time format in the <a href="syncdirs.html">directory synchronization tool</a>. Date and time formatting symbols are described <a href="configuration.html#dt_format">here</a>.<br>Default value is <code>yyyy.mm.dd hh:nn:ss</code>.</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="SaveAsymmetric">Attribute <i>Save</i><br><small>from <SyncDirs><Asymmetric></small></a></div></td>
<td class="hintcell">
Synchronize directories: save or not asymmetric mode by default.<br>
If we want to save state of mode then <code><Asymmetric Save="True"></code>
or <code><Asymmetric Save="False"></code> otherwise (by default).
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="SaveFileMask">Attribute <i>Save</i><br><small>from <SyncDirs><FileMask></small></a></div></td>
<td class="hintcell">
Synchronize directories: by default, Double Commander saves the last used file mask as the mask for the next run of the synchronization tool (if it is not a search template),
to disable this behavior, we can replace <code>True</code> with <code>False</code> (<code><FileMask Save="False"></code>) and specify the preferred file mask or "*" (i.e. all files) in the <code><FileMask></code> value.
</td>
</tr>
<tr>
<td colspan="2" class="subsection"><div class="subsection">from <Viewer>:</div></td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="AutoCopy"><AutoCopy></a></div></td>
<td class="hintcell">For the internal viewer, enables (<code>True</code>) or disables (<code>False</code>) automatic copying of the selected text to the clipboard. <code>True</code> by default.</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="ExtraLineSpanV"><ExtraLineSpan></a></div></td>
<td class="hintcell">
For the internal viewer, this setting allows to add some extra pixels to the height allowed for each line. The value is interpreted directly in pixels.<br>
Default value is 0.<br>
<i>Example:</i> <code><ExtraLineSpan>2</ExtraLineSpan></code>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="ImageExifRotate"><ImageExifRotate></a></div></td>
<td class="hintcell">
Double Commander is able to recognize the <a href="https://en.wikipedia.org/wiki/Exif" target="_blank">EXIF</a> metadata format that might be encoded into a JPEG image file.<br>
Inside that metadata, there is an <a href="https://www.impulseadventure.com/photo/exif-orientation.html" target="_blank">orientation flag</a> that may be used to display the picture into the same orientation as it was taken like if was in portrait, landscape, upside-down, mirror, etc.<br>
The <code>ImageExifRotate</code> tag configures Double Commander to indicate if we want the viewer to display the image using that information or not.<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Value</th>
<th class="innerdescheader">Description</th>
</tr>
<tr>
<td class="innerdescvaluecell">True</td>
<td class="innerdescdesccell">Use the orientation flag embedded into the image file (default).</td>
</tr>
<tr>
<td class="innerdescvaluecell">False</td>
<td class="innerdescdesccell">Ignore the orientation flag.</td>
</tr>
</table>
<i>Example:</i> <code><ImageExifRotate>True</ImageExifRotate></code>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="JpegQuality"><JpegQuality></a></div></td>
<td class="hintcell">For the internal viewer, the quality value that Double Commander will use by default when saving to JPEG format (the commands <span class="italic">Save</span> and <span class="italic">Save As...</span>). 80 by default.</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="LeftMargin"><LeftMargin></a></div></td>
<td class="hintcell">
For the internal viewer, this option allows to add space between the left border of the window and the text border. The value is interpreted directly in pixels.<br>
Default value is 4.<br>
<i>Example:</i> <code><LeftMargin>4</LeftMargin></code>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="MaxCodeSize"><MaxCodeSize></a></div></td>
<td class="hintcell">
For the internal viewer, limits the maximum file size for automatic choice of the code viewing mode (displaying text with syntax highlighting requires more resources than displaying plain text). The option value is ignored when we force the code viewing mode in the viewer window.<br>
The size is specified in megabytes, the default value is 128.
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="MaxTextWidth"><MaxTextWidth></a></div></td>
<td class="hintcell">
For the internal viewer, configure the maximum number of characters to be displayed on one text line prior to wrap it up to the next one.<br>
The valid range goes from 80 to 16384 and default value is 1024.<br>
<i>Example:</i> <code><MaxTextWidth>1024</MaxTextWidth></code>
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="SynEditMask"><SynEditMask></a></div></td>
<td class="hintcell">
For the internal viewer, this option allows to manage the list of file extensions for code view mode (of course, within the available list).
We can specify file masks (separated by semicolons ";" without spaces) that will automatically open in this mode instead of plain text, or the name of a search template to exclude. We can also disable automatic opening of files in this mode by setting an empty string.
The default value is "*".
</td>
</tr>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft"><a name="TabSpaces"><TabSpaces></a></div></td>
<td class="hintcell">
For the internal viewer, set the width of tab stops to use.<br>
The valid range goes from 1 to 32 and default value is 8.<br>
<i>Example:</i> <code><TabSpaces>4</TabSpaces></code>
</td>
</tr>
</table>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
<div>
<h2><a name="index">4. Index</a></h2>
<table class="index">
<tr>
<td class="indexcell">
<p>
<a href="#Count">Attribute <i>Count</i> (<DirHistory>)</a><br>
<a href="#SaveAsymmetric">Attribute <i>Save</i> (<Asymmetric>)</a><br>
<a href="#SaveFileMask">Attribute <i>Save</i> (<FileMask>)</a><br><br>
<a href="#ActiveRight">ActiveRight</a><br>
<a href="#AutoCopy">AutoCopy</a><br>
<a href="#AutoExtractOpenMask">AutoExtractOpenMask</a><br>
<a href="#AutoSaveWidth">AutoSaveWidth</a><br>
<a href="#ConfirmQuit">ConfirmQuit</a><br>
<a href="#CopyAttributes">CopyAttributes</a><br>
<a href="#CopyTime">CopyTime</a><br>
<a href="#CopyXattributes">CopyXattributes</a><br>
<a href="#CustomIcons">CustomIcons</a><br>
<a href="#DateTimeFormat">DateTimeFormat</a>
</p>
</td>
<td class="indexcell">
<p>
<a href="#DecimalSeparator">DecimalSeparator</a><br>
<a href="#DefaultDropEffect">DefaultDropEffect</a><br>
<a href="#DiskAlpha">DiskAlpha</a><br>
<a href="#DoubleClickEditPath">DoubleClickEditPath</a><br>
<a href="#ExtraLineSpanF">ExtraLineSpan (<FilesViews>)</a><br>
<a href="#ExtraLineSpanV">ExtraLineSpan (<Viewer>)</a><br>
<a href="#FindWordAtCursor">FindWordAtCursor</a><br>
<a href="#FolderPrePostfix">FolderPrefix and FolderPostfix</a><br>
<a href="#gBorderFrameWidth">gBorderFrameWidth</a><br>
<a href="#ImageExifRotate">ImageExifRotate</a><br>
<a href="#JpegQuality">JpegQuality</a><br>
<a href="#LeftMargin">LeftMargin</a><br>
<a href="#LongInStatus">LongInStatus</a><br>
<a href="#LongNameAlert">LongNameAlert</a>
</p>
</td>
<td class="indexcell">
<p>
<a href="#MaxCodeSize">MaxCodeSize</a><br>
<a href="#MaxTextWidth">MaxTextWidth</a><br>
<a href="#Mode">Mode</a><br>
<a href="#NtfsHourTimeDelay">NtfsHourTimeDelay</a><br>
<a href="#Quality">Quality</a><br>
<a href="#RenameConfirmMouse">RenameConfirmMouse</a><br>
<a href="#ShowColonAfterDrive">ShowColonAfterDrive</a><br>
<a href="#Sounds">Sounds</a><br>
<a href="#SynEditMask">SynEditMask</a><br>
<a href="#SystemItemProperties">SystemItemProperties</a><br>
<a href="#TabSpaces">TabSpaces</a><br>
<a href="#TitleStyle">TitleStyle</a><br>
<a href="#ToolSize">ToolSize</a><br>
<a href="#UppercaseDriveLetter">UppercaseDriveLetter</a>
</p>
</td>
</tr>
</table>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
<br>
</div>
</div>
<div class="footer"><div class="nav"><a title="Index" href="index.html">Index</a> | <a title="Previous page" href="commandline.html">Previous</a> | <a title="Next page" href="plugins.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>
|
