- 
-
- | call platform-specific functions. it has different functions across various operating systems.
+ | 
+
+ | Call platform-specific functions, it has different functions across various operating systems.
@@ -2666,7 +2695,8 @@
|
- Prompt user to rename current tab of active panel. |
+ Prompt user to rename current tab of active panel.
+ Also we can specify a new tab name as a parameter. |
diff --git a/doc/en/configuration.html b/doc/en/configuration.html
index e85e51ae..e07cb8e5 100644
--- a/doc/en/configuration.html
+++ b/doc/en/configuration.html
@@ -110,20 +110,21 @@ Content
2.16. Quick search/filter
2.17. Miscellaneous
2.18. Auto refresh
- 2.19. Icons
- 2.20. Ignore list
- 2.21. Archivers
- 2.22. Tooltips
- 2.23. File associations
+ 2.19. iCloud
+ 2.20. Icons
+ 2.21. Ignore list
+ 2.22. Archivers
+ 2.23. Tooltips
+ 2.24. File associations
- - 2.23.1. File associations extra
+ - 2.24.1. File associations extra
- 2.24. Directory Hotlist
+ 2.25. Directory Hotlist
- - 2.24.1. Directory Hotlist Extra
+ - 2.25.1. Directory Hotlist Extra
@@ -142,6 +143,7 @@
extassoc.xml – file extension association configuration;
favoritetabs.xml – favorite tabs;
history.xml – command line and directory history, search and replace, etc.;
+ localconfig.xml – directory hotlist;
multiarc.ini – external archivers;
pixmaps.txt – maps file extensions to MIME-types icon names;
session.ini – size, position and state of child program windows (these settings are saved separately for each screen resolution);
@@ -268,16 +270,7 @@
You can select fonts for the editor (F4), viewer (F3), file panels (Main Font) 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 MONOSPACE. 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.
Normal (proportional) font above, monospaced below.
- Also you can use Ctrl+mouse wheel to change the font size, this function works for the following interface elements or part of Double Commander:
-
- file list in left and right panels; current directory (address) bar; function key buttons bar; TreeView menu; search results in find files dialog; internal editor; 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).
+ Also you can use Ctrl+mouse wheel to change the font size, see the Mouse section for details.
Also you can choose the type of font rasterization (regardless of the system settings), see description of <Quality>.
@@ -304,6 +297,7 @@
Left: – files selected for copying or deleting on the left.
Right: – files selected for copying or deleting on the right.
Unknown: – files with the same names, but not identical.
+ Selection: – background color for the file under the cursor or selected files.
6. Drive Free Space Indicator – here you can change the appearance of the drive free space indicator:
@@ -368,7 +362,6 @@
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.
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, ?r* (Windows) or ?r-* (Linux) will find all read-only files and folders.
You can use a color from the list or specify yours using the ".." button.
- Do not forget to click "Apply" button after customization.
Double Commander checks the list from top to bottom until the first match: a rule higher in the list will overlap any rule below.
@@ -432,7 +425,7 @@
2.7. Mouse
- 
+
The first group of parameters is Selection:
Selection by mouse – enables the ability to select and unselect files and folders with the mouse. Line by line – the cursor remains on the file and scrolling takes place immediately. Also you can specify the number of lines. Page by page – the same as previous, but scrolling is by pages rather than by lines (much faster scrolling).
+ Zoom – Double Commander allows to use Ctrl+mouse wheel to change font sizes. It works for the following interface elements or part of the program:
+
+ file list in left and right panels; current directory (address) bar; function key buttons bar; TreeView menu; search results in find files dialog; internal viewer (if viewer shows text); internal editor.
+ Zoom with Ctrl + Scroll Wheel – enables or disables this feature.
Open with – 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:
A double click is necessary to launch the action (default). GETFILEOWNER – displays the owner of the file. GETFILELINKTO – displays the path and file, that is, what is linked with this symlink. GETFILETYPE – file type (as in Windows Explorer or MIME-type). GETFILECOMMENT – file or directory description (comment) from descript.ion (see details here). GETFILECOMMENT – file or directory description (comment) from descript.ion (see details here). This field can also be used inside archives (if the archive format supports saving file descriptions and the corresponding external archiver is configured to receive them). GETFILECOMPRESSEDSIZE – compressed file size (real size if using NTFS compression).
By default, fields with timestamps use the date and time format that was choosen in the Files views settings section. You can also specify your preferred format directly in the column inside the curly brackets, using the same date and time formatting characters.
@@ -697,14 +701,18 @@
Configure – opens the plugin's own settings window (if selected plugin supports this feature).
- 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).
- 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 directory with the configuration files, delete the pwd.ini 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 pwd.ini file.
+ Double Commander supports the use of a main 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), the Argon2 function is used to derive a key from the main password.
+ Double Commander supports two versions of the Argon2 algorithm (Argon2d and Argon2id) and allows to specify three parameters: number of iterations, memory required, degree of parallelism. RFC 9106 recommends using Argon2id if you does not know the difference between the versions or if side-channel attacks are considered to be a real threat. Increasing the number of iterations and/or memory size will increase the function's execution time and make it more difficult to crack the password; increasing the degree of parallelism (but without exceeding the number of logical cores of your processor) allows the function to work faster. It is also recommended to choose the parameters so that the function takes about 0.5-1 seconds (the more, the better, but if the values are too large, it may be inconvenient to use the main password).
+ Note: If you actively use the portable version of Double Commander on a USB flash drive on several computers or use a centralized installation of the application with configuration files, then it may be practical to choose the settings suitable for the least performance computer.
+ Note: At the moment, Double Commander does not support changing the main password: if necessary, you will need to disable the use of the main password in the plugin settings, close the program, open the directory with the configuration files, delete the pwd.ini file, run the program again and enable the main password in the plugin settings. To delete outdated or unnecessary saved passwords, you will need to close the program and manually edit the pwd.ini file.
2.10. Layout
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.
+ There are also several parameters available that can only be changed manually in the doublecmd.xml configuration file.
+ Starting from macOS 11, Double Commanderhe has a toolbar in the window header by default, in addition to the main toolbar. You can disable this UI element manually: close Double Commander, go to the configuration files directory (see details here), open the doublecmd.cfg file, find the ModernUI parameter, change its value from True to False and run the application again.
2.10.1. Layout > Drives list button
@@ -767,10 +775,12 @@
The Buffer size for file operations (in KB) and Buffer size for hash calculation (in KB) 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.
Note: The first parameter is not used in the copy function in Windows, since the system function is used for copying.
Number of wipe passes – Here you can specify the number of rewrites to secure delete files.
- Process comments with files/folders – If enabled and you have a file/folder with a comment 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.
+ Process comments with files/folders – If enabled and you have a file/folder with a comment 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. If you delete or erase a file, its comment will also be deleted. If you rename a file, its name will also be changed in the descript.ion file.
+ Otherwise, the descript.ion file will be processed as a regular file.
Skip file operations errors and write them to log window – 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 Log settings section, you can limit the total number of messages, allowing only messages with the "Error" status.
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.
Duplicated name auto-rename style – sets the file auto-renaming template if a file with the same name already exists in the target directory (i.e. when you choose Auto-rename source files or Auto-rename target files 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).
+ There are also several parameters available that can only be changed manually in the doublecmd.xml configuration file.
2.12.1. File operations > File search
@@ -870,8 +880,8 @@
Command line history – Commands that were used at the command line.
File mask history – Double Commander saves a general history of used file masks for several tools: find files, filters in directory synchronization and archive unpacking, commands for selecting and deselecting a group of files.
- The maximum number of entries in history is limited to 50.
- 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 cm_DirHistory command (default value is 30, see the Count attribute in the <DirHistory> tag), but when using the Tree View Menu, all available history will be shown.
+ The maximum number of entries in history is limited to 50 by default (see the MaxStringItems attribute in the <History> tag).
+ 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, the number of saved entries will be limited to the MaxStringItems value. You can change the number of history entries in the popup menu when calling the cm_DirHistory command (default value is 30, see the Count attribute in the <DirHistory> tag), but when using the Tree View Menu, all available history will be shown.
Note: Search templates are not related to the history and are saved separately (in the doublecmd.xml configuration file). To manage the list of templates, you can use the file search tool.
You can choose how the list of settings sections will look:
@@ -884,7 +894,7 @@
2.16. Quick search/filter
This section contains the settings of the quick search/filter tool. Quick search is used in searching for filenames in the panel, quick filter will hide all filenames that do not match the conditions.
- 
+
Exact name match:
Beginning (name must start with first typed character) – means that the typed text will match the "text*" mask, where "*" is any number of any characters. These options can be changed on the fly directly in the quick search/filter bar. Also you can toggle between search and filter.
Options:
+ Ignore diacritics and ligatures – allows to simplify the use of quick search/filter: when searching, Double Commander will replace letters with diacritics and ligatures with letters of the Latin alphabet (the table of common symbols is contained in the source code of the program). Hide filter panel when not focused – The quick search/filter panel will hide automatically as soon as you move the focus to the file panel. In brief view hiding the panel does not work correctly, so the option is ignored until a suitable solution is found. Keep saving setting modifications for next session – 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.
@@ -939,7 +950,11 @@
- 2.19. Icons
+ 2.19. iCloud
+ macOS only. This section of the settings lists installed applications that automatically create folders in iCloud Drive: you can choose the application folders that will be available in the iCloud virtual folder.
+
+
+ 2.20. Icons
The first option enables the display of the file type icons to the left of the name:
@@ -948,7 +963,12 @@
Only standard icons – Only the icons listed in the pixmaps.txt 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 pixmaps/dctheme/XxX/mimetypes in the program folder) or specify the full (with path) file name. Creating an icon theme is described in the FAQ. No icons.
- Show overlay icons, e.g. for links – If enabled, Double Commander will show overlay icons such as arrows for .lnk files and links.
+ Show overlay icons, e.g. for links – If enabled, Double Commander will show overlay icons such as arrows for .lnk files and other overlay emblems and marks:
+
+ Windows: Emblems from the operating system settings and third-party applications (for example, version control systems or local cloud storage directories). Linux and other Unix-like systems (except macOS and Haiku): RabbitVCS emblems (if available) and emblems from the GIO/GVfs metadata subsystem (as in Nautilus, Caja, Thunar, PCManFM and other supporting it).
+ The symbolic link emblem and the additional broken/dangling link emblem will be displayed in any case.
Dimmed hidden files (slower) – If enabled, Double Commander will show icons for hidden files with 50% transparency.
Disable special icons – 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.
Icon size – You can choose from the following sizes:
@@ -963,7 +983,7 @@
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.
- 2.20. Ignore list
+ 2.21. Ignore list
Ignore specific files and folders (one per line): they will not be displayed in panels.
@@ -978,11 +998,11 @@
You can use the internal command cm_SwitchIgnoreList to turn this option on and off, add a button on toolbar or hotkey.
- 2.21. Archivers
+ 2.22. Archivers
Please see the dedicated Archive handling help page about how to use and configure it.
- 2.22. Tooltips
+ 2.23. Tooltips
This section contains the settings for tooltips when the mouse cursor is hovering over a file.
Show tooltip for files in the file panel – enables the ability to use tooltips.
@@ -1023,7 +1043,7 @@
In the screenshot at the beginning of the section description, you can see an example of a tooltip with the textline.wdx plugin that shows the contents of the selected lines of a text file (in this case, the first, second and third lines), the Combine DC and system tooltip, system first mode is selected.
- 2.23. File associations
+ 2.24. File associations
This item opens the configuration file associations. All association sets are contained in the file extassoc.xml.
Here you can customize file associations and set commands or scripts for chosen file types. Commands will be added to the context menu of files. Double Commander also allows to simply set (or replace) icons for file types, without adding any actions.
@@ -1041,7 +1061,7 @@
file – any file; folder – any directory; default – used when extension specific association does not exists. default – used when extension specific internal association does not exists (only for the "Open", "View" and "Edit" actions, see below).
Insert – adds a new extension to the current position in the list.
Add – adds a new extension to the end of the list.
@@ -1081,12 +1101,12 @@
<?command?> – runs "command" in the system shell and feeds the output to the command above.
At a minimum, you must specify a file name, usually %p or %p0 for the file under cursor.
- Start path – 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 %D, %d or environment variables.
+ Start path – 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 you can use the variable %D, %d or environment variables.
All available actions will be displayed in the "Actions" submenu in the context menu:
- 2.23.1. File associations > File associations extra
+ 2.24.1. File associations > File associations extra
Offer to add selection to file association when not included already – 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.
Extended context menu – allows to add some items to the "Actions" submenu:
@@ -1110,11 +1130,11 @@
Also you can apply the chosen way to the already added paths.
- 2.24. Directory Hotlist
+ 2.25. Directory Hotlist
Please see the dedicated Directory Hotlist help page about how to use and configure it.
- 2.24.1. Directory Hotlist > Directory Hotlist Extra
+ 2.25.1. Directory Hotlist > Directory Hotlist Extra
In this section you can choose how the path will be set the path and target path:
diff --git a/doc/en/configxml.html b/doc/en/configxml.html
index 89e6d8fa..47675b6e 100644
--- a/doc/en/configxml.html
+++ b/doc/en/configxml.html
@@ -40,12 +40,12 @@
The location of this doublecmd.xml file may be in different places:
- It may be configured to be in the user home directory.
- - It may be configured to be in the program directory itself, which is commonly the case when used in a portable context.
+ - It may be configured to be in the "settings" folder in the program directory itself, which is commonly the case when used in a portable context.
- We may define its location via a command line parameter when launching the application.
We follow this link if we want to specify it by with the command line paramter --config-dir.
Other than that, we do Configuration > Options... > select in the tree  > set the option Location of configuration files.
- 
+
Another way to quickly find out where is located the doublecmd.xml the current instance of Double Commander is using is by accessing the Directory Hotlist. 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 doublecmd.xml that application is currently using.
(back to top)
@@ -152,10 +152,42 @@
Internal editor and differ tool: if nothing is selected, the search and replace dialog will use the word under the cursor (True) or text from the search history (False). True by default. |
|
+
+ |
+
+ Allows to change the visual representation of whitespace characters when Show special characters is enabled. Option will be set to a single number representing the sum of the numbers from the following table depending on what are our preferences:
+
+
+
+
+
+
+ | 1 |
+ Space characters will be displayed as a middle dot characters ("·", U+00B7). |
+
+
+ | 2 |
+ Tab characters will be displayed as a long space (see Tab width) with a right-pointing double angle quotation mark ("»", U+00BB) at the beginning. |
+
+
+ | 4 |
+ Tab characters will be displayed as a long space (see Tab width) with a right-pointing double angle quotation mark ("»", U+00BB) at the end. |
+
+
+ Default value is 5.
+ |
+
+
from <FileOperations>: |
+
+ |
+ Sets the behavior for files opened in the editor (built-in or external) from an archive or a WFX plugin.
+ Files from the virtual file system are automatically copied to the system directory for the temporary files before opening. If a file has been changed, Double Commander will prompt to copy it back (False) or copy it back automatically (True). True by default. |
+
+
|
@@ -260,8 +292,6 @@
|
|
- *** from DC 1.3, ExtraLineSpan can be set in Options > Files views extra ***
-
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.
Default value is 2.
Example: <ExtraLineSpan>2</ExtraLineSpan>
@@ -279,7 +309,7 @@
|
|
- This option changes the mouse click action when renaming a file under the cursor: if True, 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 Esc key.
+ This option changes the mouse click action when renaming the file under the cursor: if True, 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 Esc key.
False by default.
In both cases, we can still use the button to the right of the edit field to confirm the operation.
|
@@ -380,6 +410,11 @@
from <History>: |
+
+ |
+ The MaxStringItems attribute allows to specify the maximum number of entries in the saved history. Default value is 50. |
+
+
|
@@ -480,6 +515,11 @@
| from <Layout>: |
+
+ |
+ Allows us to change the position of the free space label when the drives list button is disabled: by default (False), when we disable the drives list button, its panel and free space label remain in the same place; otherwise (True), the panel will be hidden, and the free space label will be moved up to the drive buttons panel, adding space for the file list. |
+
+
|
Windows only: show colon after letters of disks in the drives button bar and in the drives list. False by default. |
@@ -561,22 +601,7 @@
Double Commander is able to recognize the EXIF metadata format that might be encoded into a JPEG image file.
Inside that metadata, there is an orientation flag 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.
- The ImageExifRotate tag configures Double Commander to indicate if we want the viewer to display the image using that information or not.
-
-
-
-
-
-
- | True |
- Use the orientation flag embedded into the image file (default). |
-
-
- | False |
- Ignore the orientation flag. |
-
-
- Example: <ImageExifRotate>True</ImageExifRotate>
+ The ImageExifRotate tag configures Double Commander to indicate if we want the viewer to display the image using that information (True) or not (False). True by default.
|
@@ -615,7 +640,7 @@
|
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.
+ 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 (with the ">" symbol before the name) to exclude. We can also disable automatic opening of files in this mode by setting an empty string.
The default value is "*".
|
@@ -639,10 +664,12 @@
Attribute Count (<DirHistory>)
+ Attribute MaxStringItems (<History>)
Attribute Save (<Asymmetric>)
Attribute Save (<FileMask>)
ActiveRight
AutoCopy
+ AutoCopyBackward
AutoExtractOpenMask
AutoSaveWidth
ConfirmQuit
@@ -659,6 +686,7 @@
DefaultDropEffect
DiskAlpha
DoubleClickEditPath
+ DriveBarFreeSpace
ExtraLineSpan (<FilesViews>)
ExtraLineSpan (<Viewer>)
FindWordAtCursor
@@ -668,12 +696,12 @@
JpegQuality
LeftMargin
LongInStatus
- LongNameAlert
+ LongNameAlert
+ MaxCodeSize
|
- MaxCodeSize
MaxTextWidth
Mode
NtfsHourTimeDelay
@@ -682,6 +710,7 @@
ShowColonAfterDrive
Sounds
SynEditMask
+ SynEditSpecialChars
SystemItemProperties
TabSpaces
TitleStyle
diff --git a/doc/en/copymove.html b/doc/en/copymove.html
index c8617660..daa07489 100644
--- a/doc/en/copymove.html
+++ b/doc/en/copymove.html
@@ -57,7 +57,7 @@
The list of the following parameters will vary depending on the type of file operation and operating system family.
- Verify – If enabled, Double Commander will compare the source file and the copied file in the target directory: a byte-by-byte comparison (Windows) or BLAKE2 checksums (Linux and others). Double Commander will try to minimize the disk cache effects (if the file system does not support direct input/output, the program will report the verification failure). Keep in mind, this function significantly reduces the speed of the operation. Please note that each file will be read twice, so the total size of files in the progress bar will be doubled. Not available in macOS. Verify – If enabled, Double Commander will compare the source file and the copied file in the target directory: a byte-by-byte comparison (Windows) or checksums (Linux and others: BLAKE3 (x86-64), BLAKE2b (other 64-bit processors) or BLAKE2s). Double Commander will try to minimize the disk cache effects (if the file system does not support direct input/output, the program will report the verification failure). Keep in mind, this function significantly reduces the speed of the operation. Please note that each file will be read twice, so the total size of files in the progress bar will be doubled. In macOS, this feature is available experimentally. Check free space – Before copying the file, Double Commander will check if there is enough free disk space in the target directory. Reserve space – If enabled, Double Commander will use pre-allocation of disk space, this will reduce the chances of file fragmentation. Also this is a faster way to create files. In Windows, Double Commander always reserves space. Does not work in Linux on partitions with FAT32 file system. Follow links – If enabled, Double Commander will consider symbolic links to folders as regular folders and copy their contents; instead of file links, the target files of this links will be copied. The indeterminate checkbox state (three-state): the program will ask each time what it should do. Content
- 2.6. Why does the program's appearance not change or change only partially when switching the system theme? I have to close the program and open it again.
- - 3. Issues related to macOS
+ - 3. Issues related to macOS
-
- 3.1. Why does DC need permissions in macOS system setting?
@@ -60,7 +60,7 @@ Content
- 4.4. How to associate my own icons with some file types?
- 4.5. How to create a splitter on the buttons panel?
- 4.6. Does DC has other icon themes?
- - 4.7. How to make function keys and address bar bigger?
+ - 4.7. How to make function keys, address bar and other interface elements bigger?
- 4.8. File panels: how to change the height of elements (strings) and the intervals between them?
@@ -78,6 +78,7 @@ Content
- 5.9. In some cases I see warning "Can not set [attributes, date/time, owner/group or permissions] for xxx" when I copy or move files, I want that DC use action "skip"/"skip all" by default. How I can do it?
- 5.10. Why doesn't the program show a list of admin shares?
- 5.11. I assigned the left and right arrows to navigate back and forth through the directory history, but now I can't use them while renaming a file. How to fix it?
+ - 5.12. Is there a way to add sound notifications when operations are completed?
- 6. Issues related to the built-in viewer (F3) and editor (F4)
@@ -194,7 +195,7 @@ 2. Issues related to GNU/Linux
First, packages gvfs, gvfs-backends and gvfs-fuse should be installed.
Keep in mind that some distributions have not packages gvfs-backends and gvfs-fuse,
because they are part of package gvfs, or it can be several packages with names gvfs-backends-* or gvfs-*.
- Now insert GVfs path in the address bar: click by right mouse button at address bar to edit it (or call internal command cm_EditPath).
+ Now insert GVfs path in the address bar: click by right mouse button at address bar to edit it (or call internal command cm_EditPath). Alternatively, you can use the internal command cm_MapNetworkDrive.
For example, access to
- FTP:
ftp://ftpuser@ftpserver
@@ -220,22 +221,23 @@ 3. Issues related to macOS
A: Because macOS is becoming increasingly strict with the default permissions of apps, and DC, as a file manager, needs to access many restricted files.
- Without proper authorization, DC may not work correctly with Finder Tags, Time Machine snapshot files, iCloud Drive, etc.
- - Clicking the authorization icon in the upper right corner of DC will guide you to the
System Settings > Privacy & Security > Privacy > Full Disk Access panel.
+ - Clicking the authorization icon in the upper right corner of DC will guide you to the System Settings > Privacy & Security > Privacy > Full Disk Access panel.
- From DC 1.3, the authorization icon will be hidden if the authorization has already been granted.
+
+
Q: I clearly remember granting permissions to the DC before, and I found DC in the authorization list, but why is DC still not authorized now?
- A: You must have installed a new version of DC after the last authorization.
+ A: You probably installed a new version of DC after the last authorization.
- You must re-authorize every time you install a new version.
- In this case you need to remove DC from the list first and then add DC back again.
- Because the new version has different fingerprints, simply enabling the checkboxes will not work.
+
+
Q: How to add Shortcuts for specific macOS functions?
- A: As the example shown in the screenshot, we can follow Finder's convention and reset Spacebar as the shortcut for QuickLook:
- The key is setting func=QuickLook as the parameter of the cm_CallPlatformFunctions.
- 
- By the same way, we can set Shortcuts for Share, AirDrop, QuickLook, RevealInFinder, ShowInfoInFinder, EditFinderTags, etc. by cm_CallPlatformFunctions.
- We can also set Shortcuts for iCloud, Stash, cloud, FTP, Network, etc. by cm_OpenVirtualFileSystemList.
+ A: You can add a shortcut for the cm_CallPlatformFunctions command and specify the required parameter (func=AirDrop, func=QuickLook, func=EditFinderTags, etc).
+ Also note the cm_OpenVirtualFileSystemList command.
(back to top)
@@ -279,6 +281,7 @@ 4. Interface configuration
2. If you want to keep some existing default icons then just delete them in "mydctheme" and DC will use them from default theme.
3. Some nonstandard icon sizes (such as 40x40, 60x60 and so one) uses for HiDPI monitors.
4. Also see <CustomIcons>.
+ Double Commander supports packing icons into a ZIP file (without compression!): pack 8x8 - scalable folders into the icon-theme.zip archive, delete them and icon-theme.cache (if exists), restart the application.
How to install:
1. Portable version
Copy (or move) your "mydctheme" folder to the "pixmaps" folder near doublecmd.exe, restart DC, go to "Configuration" in the main menu > Options... > Icons > Icon theme, choose your theme and restart DC again.
@@ -295,26 +298,20 @@ 4. Interface configuration
Now restart DC, go to "Configuration" in the main menu > Options... > Icons > Icon theme, choose your theme and restart DC again.
- Q: How to make function keys and address bar bigger?
- A: The size depends on the font size, three ways exists:
- 1. Simple and fast: you can use Ctrl+mouse wheel, it works for the following interface elements or part of DC:
- - file list in left and right panels;
- - current directory (address) bar;
- - function key buttons bar;
- - TreeView menu;
- - search results in find files dialog;
- - internal editor;
- - 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).
+ Q: How to make function keys, address bar and other interface elements bigger?
+ A: The size depends on the font size, several ways exists:
+ 1. Simple and fast: you can use Ctrl+mouse wheel, see Zoom.
2. Go to "Configuration" in the main menu > Options... > Fonts.
Note: All possible are available in version 1.0.0+ only, for 0.9.x and below additionally see the third item.
- 3. Close DC > open doublecmd.xml > find tag <Fonts></Fonts> and change <Size> of the interface element manually.
+ 3. For file panels, you can use the internal commands cm_MainFontZoomOut and cm_MainFontZoomIn. Similar commands are available in the built-in viewer and editor.
+ 4. Close DC > open doublecmd.xml > find tag <Fonts></Fonts> and change <Size> of the interface element manually.
Q: File panels: how to change the height of elements (strings) and the intervals between them?
A: The view depends on the following parameters:
- - Configuration > Options... > Fonts > Main font
- - Configuration > Options... > Icons > Icon size > File panel
+ - Configuration > Options... > Fonts > Main font
+ - Configuration > Options... > Icons > Icon size > File panel
- <ExtraLineSpan> (from
<FilesViews>)
(back to top)
@@ -378,6 +375,10 @@ 5. Issues related to control and navigation
Q: I assigned the left and right arrows to navigate back and forth through the directory history, but now I can't use them while renaming a file. How to fix it?
A: When assigning a hot key, Double Commander allows to limit the scope of the keyboard shortcut, see Only for these controls.
In this case, you need to enable the "Files Panel".
+
+
+ Q: Is there a way to add sound notifications when operations are completed?
+ A: See description of <Sounds>.
(back to top)
diff --git a/doc/en/findfiles.html b/doc/en/findfiles.html
index e7b3546f..962185f0 100644
--- a/doc/en/findfiles.html
+++ b/doc/en/findfiles.html
@@ -69,6 +69,7 @@
This setting controls the depth of the search in the filesystem tree. If set to "current dir only", the search will only be conducted in the directory specified in the "Start in directory" field (not in any subdirectories).
The File mask field sets the mask for the search. Or we can just specify the file name or part of it.
+ Note: Keep in mind that Double Commander saves a general history of file masks for several tools: find files, directory synchronization, archive unpacking, commands for selecting a group of files.
Additional options:
Search in archives – if enabled, Double Commander will try to additionally read the contents of all archives in the search directory(ies). The list of supported formats depends on the added packer plugins.
compare file names; compare file sizes; compare file hashes: BLAKE2b (x64) or BLAKE2s checksum will be used; compare file hashes: BLAKE3 (x86-64), BLAKE2b (other 64-bit processors) or BLAKE2s checksum will be used; compare file content (byte-by-byte comparison).
In the result will be shown file names, group number of matching files and file locations. Also after feed to listbox we can use special selection mode, where we can select only duplicates:
@@ -293,6 +294,7 @@
string does not match regular expression |
|
+ Depending on the type of data returned by the plugin field, a value input assistant will be available: calculator (number) or calendar (date and/or time).
(back to top)
@@ -310,7 +312,8 @@
View – opens selected file in the viewer (F3). Edit – opens selected file in the editor (F4). Go to file – closes search window, opens the directory of the selected file in the active file panel and places the cursor on this file (Enter or double click). Go to file – closes search window, opens the directory of the selected file in the active file panel and places the cursor on this file (Enter or double click).
+ To keep the search window open, we can use the Space key or assign any other hotkey for the cm_GotoFile command and add close=0 in the parameters. Feed to listbox – transfers a list of the found files in the active file panel.
The context menu is also available:
@@ -323,6 +326,7 @@
To select several files, we can use the mouse and the Ctrl and Shift keys or Shift and arrows.
The left arrow and right arrow keys switch the focus between the list of search result and the New search button.
+ The list of found files will be cleared when we start a new search or close the application, this means we can open the search dialog again and view the result of the previous search.
(back to top)
diff --git a/doc/en/help.html b/doc/en/help.html
index addffaf5..29ee26dc 100644
--- a/doc/en/help.html
+++ b/doc/en/help.html
@@ -121,7 +121,7 @@
This menu contains almost all the actions that can be made on files. Please consider all the items:
Create Symbolic Link... (internal command cm_SymLink). With this item, Double Commander creates a symbolic link to the file under the cursor and places it in the folder opened in the opposite panel.
- 
+
Link name – here is the path to the link and its name. The name is the last word after the last directory separator character in the line.
Destination that the link will point to – the object, on which the link is created.
Use relative path when possible – if possible, Double Commander will use the relative path to the object directory.
@@ -129,7 +129,7 @@
Create Hard Link... (internal command cm_HardLink). Like the symbolic link above, but link is hard and using a relative path will not be available.
Create Directory (internal command cm_MakeDir) – creates a new subdirectory in the current directory. The file name (without extension) or directory name under the cursor will be offered, this is useful for creating multiple directories with similar names. You can also create several subdirectories in one operation, just separate the subdrectories with the directory separator (in Unix/Linux system it will be "/" and in Windows it will be "\").
- 
+
The button with an arrow opens the history of the entered names. The button to the right of the input field allows to enable or disable auto-completion from the directory creation history.
If Extended syntax is enabled, the <[] template can be used to insert the current date/time: inside square brackets you can use date and time formatting characters and any characters allowed for filenames.
@@ -145,8 +145,8 @@
which indicates the file or folder name, MIME type, size, write and last access time. For links, Double Commander will additionally show the link object (symbolic link) or their total number (hard link). On the "Attributes" tab you can change the access rights to the file and its owner (if you have the rights to do so). The "Plugins" tab is optional and is only available if you have a suitable content plugin (in this case it was DEB). Also see description of <SystemItemProperties>.
- Using item Edit comment... (internal command cm_EditComment) you can create or change file comments, which stored in a file descript.ion. Supports UTF, ISO, KOI and ANSI encodings. In the Miscellaneous settings section you can set the default text encoding.
- Comments only work with normal files on the local file system, but not on remote or virtual file systems (e.g. on FTP server, in archive, etc.). In order for Double Commander to take into account the contents of descript.ion when copying or moving files, make sure that Process comments with files/folders is enabled in the File operations settings section.
+ Using item Edit comment... (internal command cm_EditComment) you can create or change file comments, which stored in a file descript.ion (to delete a comment, open the dialog window and clear the edit field). Supports UTF, ISO, KOI and ANSI encodings. In the Miscellaneous settings section you can set the default text encoding.
+ Comments only work with normal files on the local file system, but not on remote or virtual file systems (e.g. on FTP server, in archive, etc.). In order for Double Commander to take into account the contents of descript.ion when performing file operations, make sure that Process comments with files/folders is enabled in the File operations settings section.
Calculate Occupied Space (internal command cm_CalculateSpace) item calculates the size of selected objects in rounded units and in bytes.
@@ -183,12 +183,13 @@
The action of the Configure button depends on the selected archiver:
packer plugins (WCX): opens the plugin's own settings window (if selected plugin supports this feature); external archivers: opens a window with an input field for additional archiver parameters (when using the %S variable). external archivers: opens a window with an input field for additional archiver parameters (when using the %S variable). Double Commander automatically saves the entered parameter string, the button with an arrow will open the list of previously saved ones (see description of AskHistory).
Also we can unpack files via Extract Files (internal command cm_ExtractFiles). The same dialog is called when you copy files from the archive.
- In the Extract files matching file mask line, you can specify a mask, determining which files will be unpacked. The history of masks can be found in the drop-down list.
- The next line specifies the destination directory (where the archive will be unpacked). It can be changed manually or by clicking on the browse button at the far right.
+ In the Extract files matching file mask line, you can specify a mask, determining which files will be unpacked. The history of masks can be found in the drop-down list.
+ Note: Keep in mind that Double Commander saves a general history of file masks for several tools: find files, directory synchronization, archive unpacking, commands for selecting a group of files.
+ The next line specifies the destination directory (where the archive will be unpacked). It can be changed manually or by clicking on the browse button at the far right.
Unpack each archive to a separate subdir (name of the archive) – If checked, Double Commander will create a folder with the same name as the archive in the destination directory and extract the files into this folder. You can extract several archives at once with this option and each will be extracted into its own folder in the target directory. The indeterminate checkbox state (three-state) enables the smart extract: if there are several objects in the root of the archive, then the contents of the archive will be unpacked into a folder with the name of the archive, but if there is one object, then the contents will be unpacked as is. By default it is unchecked and its state is not saved for the next call of the extract command.
Unpack path names if stored with files – If checked, the directory structure in the archive will be kept. Otherwise, all files will be extracted without re-creating the directory structure.
Checkbox Overwrite existing files disables confirmation of overwriting existing files.
@@ -214,10 +215,12 @@
Item Calculate check sum... (internal command cm_CheckSumCalc) is used to calculate the checksum to check files integrity. The following checksums are available:
BLAKE2 (BLAKE2s, BLAKE2sp, BLAKE2b, BLAKE2bp), BLAKE3, CRC32, HAVAL, MD4, MD5, RIPEMD128, RIPEMD160, SFV, SHA,
- SHA2 (digest sizes 224, 256, 384 or 512 bits), SHA3 (digest sizes 224, 256, 384 or 512 bits), Tiger/192.
- 
+ SHA2 (digest sizes 224, 256, 384 or 512 bits), SHA3 (digest sizes 224, 256, 384 or 512 bits), Tiger/192,
+ XXH128 (XXH3 with 128 bit digest size).
+
Save checksum file(s) to: – line specifies name and path to the calculated checksum.
Create separate checksum files for each file – if checksum calculates for multiple files, this option allows to create separate checksum files for each target file.
+ Create separate checksum file for each directory – Double Commander will scan the selected folders or the folder under the cursor and create separate checksum files in each subdirectory. The program will not take into account the ignore list and the status of the Show system and hidden files option.
Open checksum file after job is completed – after the operation is completed, the checksum file will be opened in the file viewer.
File format – allows to specify the line ending type and directory separator instead of the commonly used values in Windows (CRLF and "\") and Unix-like systems (LF and "/").
@@ -238,7 +241,9 @@
There are some commands in this group with which you can select files in different ways.
- First and second items Select a Group and Unselect a Group (internal commands cm_MarkPlus and cm_MarkMinus). These commands select groups of files by a mask. With this mask you can specify file names or extensions (you can specify several values separated by semicolons ";" without spaces). Also there is a drop-down list with masks history. For example, select all files that have the .txt extension:
+ First and second items Select a Group and Unselect a Group (internal commands cm_MarkPlus and cm_MarkMinus). These commands select groups of files by a mask. With this mask you can specify file names or extensions (you can specify several values separated by semicolons ";" without spaces). Also there is a drop-down list with masks history.
+ Note: Keep in mind that Double Commander saves a general history of file masks for several tools: find files, directory synchronization, archive unpacking, commands for selecting a group of files.
+ For example, select all files that have the txt extension:
The Define... button allows to create a new search template.
If the duplicate search result is open in the active panel, these commands will work in a special mode:
@@ -282,6 +287,7 @@
Open VFS List (internal command cm_OpenVirtualFileSystemList) will open a list of added file system plugins (WFX plugins) that use their own file systems or provide access to other file systems and devices (local or remote). As well as virtual folders:
Computer – contains a list of normal disks with a drive letter and devices that do not have a drive letter (for example, USB devices that are connected via the MTP protocol, i.e. smartphones, tablets or players). Windows only. iCloud – access to iCloud Drive contents. Additionally, you can choose the application folders that will be available in this virtual folder. macOS only. Linux – list of all Linux distributions that you added to WSL and their root file systems (Windows 10 and newer). Network – access to shared network resources (Windows) or to network resources using Gio (Linux). Recycle Bin – access to files deleted to the trash. 
Shows the column names. On left click sorts files by column. A small arrow to the left of the header text shows the sort direction. Also you can set the sort order for multiple columns by clicking on the header while holding down the Ctrl key. For example, try to sort files by extension, now click on the "Date" header with the Ctrl key: each file type will be sorted by date independently of the others.
- The tabstop headers bar allows to change the width of the columns using the mouse, by default DC changes it for both panels and saves a new value for the next launches (see <AutoSaveWidth>).
+ The tabstop headers bar allows to change the width of the columns using the mouse by simply dragging the borders, by default DC changes it for both panels and saves a new value for the next launches (see <AutoSaveWidth>).
On right click shows a menu to change and edit custom column style set.
Default, File count – existing styles.
@@ -570,17 +576,19 @@
Double Commander allows to rename files directly in the file panel. There are several ways to call this operation: the internal command cm_RenameOnly (F2 or Shift+F6 by default), the left mouse click or the corresponding item in the right mouse button menu.
By default, Double Commander will select the file name completely, but you can enable file name selecting without an extension. Also, repeated hotkey presses allow to select the file name in parts, the following characters are used as a separator: space, hyphen underscore and period. Folder names are always selected completely.
To confirm the change in the name, use the Enter key or the rename confirmation button to the right of the edit field. To cancel unconfirmed changes (to exit editing mode), use the Esc key or the mouse click outside the edit field. You can use a mouse click outside the edit field to confirm the renaming (as in Windows Explorer), see the description of <RenameConfirmMouse>.
+ Using the up and down arrows, you can rename several files sequentially: the new file name will be automatically saved when you go to edit the name of the next or previous file. To exit this mode, use the methods described above to confirm or cancel the operation.
For group renaming files, the appropriate tool is available.
Quick search/filter
When using the quick search/filter tool, its panel is displayed at the bottom of the file panel. Quick search is used to search through the current contents of the file panel: the cursor will be moved to the nearest matching file and when using the up arrow and down arrow keys, the program will move the cursor in a circle only over files whose names match the conditions. Quick filter will hide all file names that do not match the conditions (to reset the filter, use the Esc key or the "X" button).
- 
+
Filter – search/filter switch; { – name must start with first typed characters; } – last characters before a typed dot "." must match; Aa – case sensitive; Ďï – diacritics and ligatures; F – filter files; D – filter directories; X – disable quick search and close the panel.
- In order to interpret Lua script file, we need to have a Lua DLL file, Double Commander supports versions 5.1 - 5.4.
+ In order to interpret Lua script file, we need to have a Lua DLL file, Double Commander supports versions 5.1 - 5.5.
We can use DLL file from LuaJIT project. LuaJIT combines a high-speed interpreter, written in assembler, with a state-of-the-art JIT compiler. Also we get FFI library, which allows calling external C functions and using C data structures from pure Lua code.
DC distributives for Windows have Lua DLL by default (in DC 0.9.7 and newer from LuaJIT project), in other cases we may find and install it through our packages manager or compile it. If we're using a 64-bits version of DC, the DLL must be the 64-bits version as well.
By default DC looks for a file with name lua5.1.dll (Windows), liblua5.1.so.0 (Unix or GNU/Linux) or liblua5.1.dylib (macOS) in its directory and in the system directory. We can change the file name (and path) in the Lua library file to use parameter.
@@ -160,9 +160,9 @@
Write a message to the log window:
- sMessage : The message text.
- - iMsgType : The message type: 0 - information, 1 - success, 2 - error.
- - bForce : A boolean, when true, will show the log window if invisible.
- - bLogFile : A boolean, when true, will write the message also in the log file.
+ - iMsgType : The message type: 0 - information (by default), 1 - success, 2 - error.
+ - bForce : A boolean, when true, will show the log window if invisible.
true by default
+ - bLogFile : A boolean, when true, will write the message also in the log file.
false by default
The internal function of Double Commander for writing to the protocol works asynchronously (see notes in the introduction), so messages from DC.LogWrite will not be written to the protocol immediately, but after the script is completed. If it is necessary to write the text immediately, we can try to add the call DC.ExecuteCommand("") after DC.LogWrite.
|
diff --git a/doc/en/multiarc.html b/doc/en/multiarc.html
index b0f2d6fc..cfdf6d54 100644
--- a/doc/en/multiarc.html
+++ b/doc/en/multiarc.html
@@ -51,7 +51,8 @@ Content
4.11. Configuring the "Create self extracting archive" action
4.12. Configuring the "ID's"
4.13. Debugging
- 4.14. Menu of the "Other" button
+ 4.14. Additional settings
+ 4.15. Menu of the "Other" button
5. Opening an archive file in an associated application
@@ -71,7 +72,7 @@
Once "inside" the compressed file, we may do some minimal basic functions like viewing the file, copy it to the other panel and some limited function like that.
The next following image shows us an example where we selected the compressed file "help.rar" and we simply press Enter in it just like it would be a directory:
- After calling the view (F3) or edit (F4) command, Double Commander will extract the file under the cursor to the system directory for the temporary files and open it. After closing the viewer, the temporary file will be deleted. If the file opened in the editor is changed, Double Commander will offer to pack it back (if the compressed file format and the packer plugin or external archiver support this feature).
+ After calling the view (F3) or edit (F4) command, Double Commander will extract the file under the cursor to the system directory for the temporary files and open it. After closing the viewer, the temporary file will be deleted. If the file opened in the editor is changed, Double Commander can pack it back (if the compressed file format and the packer plugin or external archiver support this feature), see <AutoCopyBackward>.
When using a double-click or pressing Enter, Double Commander will show the properties window of the packed file:
The Packer line displays the name of the packer plugin used or the name of the external archiver.
@@ -115,7 +116,7 @@
extract one file or a list of file from an archive file.
This will be done by doing Configuration Options Archiver as illustrated below:
- 
+
All settings are stored in the multiarc.ini file.
Let's see in the following sections the versatile possibilities Double Commander offers us to properly integrate the usage of an external packer.
(back to top)
@@ -135,7 +136,7 @@
We then need to indicate us a significant description for the archiver, the exact location where is the executable of the archiver and then associated file extension, without the period, to that archiver.
If we have more than one possible, just add them with a single comma between each one, no space.
- 
+
Note: Double Commander supports double extensions (for example, "tar.gz", "tar.xz" and so on), they must be placed in the beginning of the list of extensions (i.e. "tar.gz" before "gz").
(back to top)
@@ -507,7 +508,33 @@
-
+
+
Several parameters that can be added or changed manually in the multiarc.ini configuration file directly or by exporting/importing archiver settings.
+
+
+
AskHistory0 ... AskHistory50
+
The values store additional archiver parameters that we have added in the file packaging dialog. We can manually change them, add new ones or delete unnecessary ones.
+
This is a convenient way to store several sets of parameters that are more suitable for different groups of files and tasks.
+
+
+
FallBackArchivers
+
Allows to specify several executable files of archivers separated by commas (full file names or names without path). If the executable file from the "Archiver" field is not found, the application will use the first one found from the FallBackArchivers value.
+
For an example, see using 7-Zip in multiarc.ini in the "default" folder.
+
+
+
IgnoreString0 ... IgnoreString50
+
This is a way to specify lines that Double Commander should ignore when parsing the archiver output.
+
If the value starts with the caret symbol ("^"), the text must be in the beginning of the ignored lines. Otherwise, the text can be located anywhere in the line.
+
+
+
SizeStripChars
+
It's rare, but the archiver can display file sizes with digit grouping (for example, "12,345" or "12 345" instead of "12345"). SizeStripChars allows to specify the character that should be removed.
+
If we need to specify several characters (for example, the value may depend on the regional settings of the operating system), they must be listed without a separator.
+
(back to top)
+
diff --git a/doc/ru/configuration.html b/doc/ru/configuration.html
index 8a86e5be..01765bec 100644
--- a/doc/ru/configuration.html
+++ b/doc/ru/configuration.html
@@ -110,20 +110,21 @@ Содержание
2.16. Быстрый поиск/фильтр
2.17. Разное
2.18. Автообновление
- 2.19. Значки
- 2.20. Список исключений
- 2.21. Архиваторы
- 2.22. Подсказки
- 2.23. Файловые ассоциации
+ 2.19. iCloud
+ 2.20. Значки
+ 2.21. Список исключений
+ 2.22. Архиваторы
+ 2.23. Подсказки
+ 2.24. Файловые ассоциации
- - 2.23.1. Файловые ассоциации (дополнительно)
+ - 2.24.1. Файловые ассоциации (дополнительно)
- 2.24. Избранные каталоги
+ 2.25. Избранные каталоги
- - 2.24.1. Избранные каталоги (дополнительно)
+ - 2.25.1. Избранные каталоги (дополнительно)
@@ -142,6 +143,7 @@
extassoc.xml – настройки файловых ассоциаций;
favoritetabs.xml – избранные вкладки;
history.xml – история каталогов, командной строки, поиска и так далее;
+ localconfig.xml – избранные каталоги;
multiarc.ini – внешние архиваторы;
pixmaps.txt – сопоставляет расширения файлов с именами значков MIME-типов;
session.ini – размер, положение и состояние дочерних окон программы (эти параметры сохраняются отдельно для каждого разрешения экрана);
@@ -268,16 +270,7 @@
Здесь можно выбрать шрифты для редактора (F4), просмотрщика (F3), файловых панелей (Основной) и других элементов интерфейса Double Commander, а также их размеры. Для каждого вы можете видеть выбранный шрифт. Одно важное замечание: шрифты для редактора и просмотрщика должны быть МОНОШИРИННЫЕ. На изображении ниже показан пропорциональный шрифт (обратите внимание на странный интервал) и моноширинный шрифт, который отображается с правильными интервалами. Кроме того, с некоторыми пропорциональными шрифтами символы могут налезать друг на друга и выглядеть довольно странно.
Вверху обычный, пропорциональный, шрифт, внизу моноширинный.
- Также для изменения размера шрифта вы можете использовать Ctrl+колесо мыши, эта функция работает для следующих элементов интерфейса или частей Double Commander:
-
- список файлов в левой и правой панелях; панель текущего каталога (адреса); панель функциональных клавиш; древовидное меню; результаты поиска в диалоге поиска файлов; встроенный редактор; встроенный просмотрщик (если просмотрщик показывает текст, то это действие изменит размер шрифта, если изображение – действие будет работать как команды увеличения/уменьшения).
+ Также для изменения размера шрифта вы можете использовать Ctrl+колесо мыши, подробнее смотрите в разделе Мышь.
Также вы можете выбрать тип растеризации шрифтов (независимо от системных настроек), смотрите описание <Quality>.
@@ -304,6 +297,7 @@
Слева: – файлы, выбранные для копирования или удаления слева.
Справа: – файлы, выбранные для копирования или удаления справа.
Неизвестно: – файлы с одинаковыми именами, но не идентичные.
+ Выделение: – цвет фона для файла под курсором или выделенных файлов.
6. Индикатор свободного места – здесь вы можете изменить вид индикатора свободного места на диске:
@@ -368,7 +362,6 @@
Вторая часть шаблона для Unix/Linux отображает права доступа: чтение (r), запись (w), выполнение (x). Значения сгруппированы по три в следующем порядке: пользователь (владелец), группа пользователя, все остальные.
Если атрибут не должен быть установлен, его нужно заменить символом "-", ненужные следует скрыть: звёздочка "*" обозначает любое количество символов, знак вопроса "?" – любой один символ. Например, с ?r* (Windows) или ?r-* (Linux) будут найдены все файлы и папки только для чтения.
Вы можете использовать цвет из списка или указать свой с помощью кнопки "..".
- Не забывайте нажимать на кнопку "Применить" после внесения изменений в список или в свойства.
Double Commander проверяет список сверху вниз до первого совпадения: правило, находящееся выше в списке, будет перекрывать любое правило ниже.
@@ -432,7 +425,7 @@
2.7. Мышь
- 
+
Первая группа параметров Выделение:
Выделение с помощью мыши – включает возможность выделять и снимать выделение с файлов и папок с помощью мыши. Построчно – то же самое, только без движения курсора, он будет оставаться в одном положении. Также вы можете указать количество строк. Постранично – как предыдущее, но прокрутка осуществляется по страницам, а не по строкам (более быстрая прокрутка).
+ Масштабирование – Double Commander позволяет использовать Ctrl+колесо мыши для изменения размеров шрифтов. Работает для следующих элементов интерфейса или частей программы:
+
+ список файлов в левой и правой панелях; панель текущего каталога (адреса); панель функциональных клавиш; древовидное меню; результаты поиска в диалоге поиска файлов; встроенный просмотрщик (если просмотрщик показывает текст); встроенный редактор.
+ Масштабирование с Ctrl+колесо мыши – включает или отключает эту возможность.
Открытие файлов и запуск программ – задаёт поведение при щелчке мыши по элементу списка файловой панели:
- Перемещать изменённые файлы – задаёт позицию, если свойство файла, используемое в данный момент для сортировки, было изменено (дата модификации, размер и т. д.):
+ Перемещать изменённые файлы – задаёт позицию, если свойство файла, используемое в данный момент для сортировки, было изменено (дата модификации, размер и т.д.):
не менять позицию; использовать то же, что и для новых файлов; GETFILEOWNER – владелец файла. GETFILELINKTO – путь и файл, на который указывает символьная ссылка. GETFILETYPE – тип файла (как в Проводнике Windows или MIME-тип). GETFILECOMMENT – описание (комментарий) файла или каталога из файла descript.ion (подробнее смотрите здесь). GETFILECOMMENT – описание (комментарий) файла или каталога из файла descript.ion (подробнее смотрите здесь). Это поле также можно использовать внутри архивов (если формат архивов поддерживает сохранение описания файлов и соответствующий внешний архиватор настроен на их получение). GETFILECOMPRESSEDSIZE – размер сжатого файла (реальный размер, если используется сжатие NTFS).
По умолчанию в полях с отметками времени используется формат даты и времени, который был выбран в разделе настроек Список файлов. Также вы можете задать предпочитаемый формат непосредственно в колонке внутри фигурных скобок, используя те же символы форматирования даты и времени.
@@ -651,7 +655,7 @@
Назад, Далее – переключают колонки.
Настроить колонку – показывает имя настраиваемой колонки.
>> – кнопка для выбора любого цвета из палитры.
- R – возвращает значение по умолчанию.
+ С – возвращает значение по умолчанию.
Все – применяет изменение и на все остальные колонки.
@@ -697,14 +701,18 @@
Настроить – открывает собственное окно настроек плагина (если выбранный плагин поддерживает эту функцию).
- Double Commander поддерживает использование главного пароля для защиты паролей в WCX- и WFX-плагинах (если разработчик плагина предусмотрел использование этой возможности). Это удобно, потому что ваши пароли будут защищены шифрованием и вам нужно запомнить только один пароль. Пароли шифруются два раза: сначала с помощью Blowfish (448 бит), потом с помощью AES (256 бит).
- Примечание: На данный момент программа не поддерживает изменение главного пароля: при необходимости вам потребуется отключить использование главного пароля в настройках плагина, закрыть программу, открыть каталог с файлами конфигурации, удалить файл pwd.ini, снова запустить программу и включить главный пароль в настройках плагина. Чтобы удалить устаревшие или ненужные сохранённые пароли, вам потребуется закрыть программу и вручную отредактировать файл pwd.ini.
+ Double Commander поддерживает использование главного пароля для защиты паролей в WCX- и WFX-плагинах (если разработчик плагина предусмотрел использование этой возможности). Это удобно, потому что ваши пароли будут защищены шифрованием и вам нужно запомнить только один пароль. Пароли шифруются два раза, сначала с помощью Blowfish (448 бит), потом с помощью AES (256 бит), для формирования ключа из главного пароля используется функция Argon2.
+ Double Commander поддерживает две версии алгоритма Argon2 (Argon2d и Argon2id) и позволяет указать три параметра: количество итераций, требуемая память, степень параллелизма. RFC 9106 рекомендует использовать Argon2id, если вы не знаете разницы между версиями или если атаки по сторонним каналам считаются реальной угрозой. Увеличение количества итераций и/или размера памяти увеличит время работы функции и усложнит возможность взлома пароля; увеличение степени параллелизма (но не превышая количество логических ядер вашего процессора) позволяет ускорить работу функции. Также рекомендуется подобрать параметры таким образом, чтобы выполнение функции занимало около 0,5-1 секунды (чем больше, тем лучше, но при слишком больших значениях может быть неудобно пользоваться главным паролем).
+ Примечание: Если вы активно используете портативную версию Double Commander на USB-флешке на нескольких компьютерах или используете централизованную установку приложения с файлами конфигурации, то может быть практичным выбор параметров, подходящих для наименее производительного компьютера.
+ Примечание: На данный момент программа не поддерживает изменение главного пароля: при необходимости вам потребуется отключить использование главного пароля в настройках плагина, закрыть программу, открыть каталог с файлами конфигурации, удалить файл pwd.ini, снова запустить программу и включить главный пароль в настройках плагина. Чтобы удалить устаревшие или ненужные сохранённые пароли, вам потребуется закрыть программу и вручную отредактировать файл pwd.ini.
2.10. Вид окна
Тут можно изменить вид главного окна Double Commander. Полагаю, проблем здесь возникнуть не должно, все опции видны на изображении выше. На изображении ниже показано, как выглядит DC с отключенными элементами управления и дополнительными окнами.
+ Также доступно несколько параметров, которые можно изменить только вручную в файле конфигурации doublecmd.xml.
+ Начиная с macOS 11 в Double Commander по умолчанию помимо основной панели инструментов включена панель инструментов в заголовке окна. Вы можете отключить использование этого элемента пользовательского интерфейса вручную: закройте Double Commander, перейдите в каталог файлов конфигурации (подробнее смотрите здесь), откройте файл doublecmd.cfg, найдите параметр ModernUI, измените значение с True на False и снова запустите приложение.
2.10.1. Вид окна > Кнопка списка дисков
@@ -767,10 +775,12 @@
Параметры Размер буфера для файловых операций (Кб) и Размер буфера для вычисления хеша (Кб) задают размер выделенной памяти для таких операций, как копирование, перемещение, разрезание или сборка файлов, поиск файлов по содержимому и вычисление контрольных сумм. Следует иметь в виду, что универсального значения не существует, но можно попробовать найти более подходящий размер.
Примечание: Первый параметр не используется в функции копирования в Windows, так как для копирования применяется системная функция.
Число перезаписей при стирании (Wipe) – Здесь вы можете указать количество перезаписей для безопасного удаления файлов.
- Обрабатывать комментарии с файлами/папками – Если включено, то при копировании или перемещении файла/папки с добавленным комментарием файл комментария также будет скопирован или перемещён в каталог назначения.
+ Обрабатывать комментарии с файлами/папками – Если включено, то при копировании или перемещении файла/папки с добавленным комментарием, комментарий также будет скопирован или перемещён в каталог назначения. При удалении или стирании файла будет удалён и его комментарий. Если вы переименуете файл, его имя также будет изменено в файле descript.ion.
+ В противном случае файл descript.ion будет обработан как обычный файл.
Выводить сообщения об ошибках файловых операций только в окно протокола – В случае возникновения ошибки файловой операции, сообщение об ошибке появится в окне протокола под файловыми панелями, без появления диалогового окна. Это может быть полезно, потому что окно ошибки приостановит операцию. В разделе настроек Протокол вы можете ограничить общее количество сообщений, разрешив только сообщениями со статусом "Ошибка".
Параметр учитывается в большинстве файловых операций: копирование, перемещение, удаление, стирание, объединение и разрезание файлов, установка свойств файла (отметки времени, владелец, атрибуты), подсчёт контрольной суммы, а также файловые операции при работе с архивами, WFX-плагинами и GVfs.
Стиль автопереименования совпадающих имён – задаёт шаблон автопереименования файла, если файл с таким именем уже существует в целевом каталоге (то есть, когда вы выбираете Автоматически переименовывать копируемые файлы или Автоматически переименовывать имеющиеся файлы в диалоге копирования/перемещения): "Копия (x) имяфайла.тип", "имяфайла (x).тип" или "имяфайла(x).тип", где "x" – счётчик (2, 3, 4 и т.д.).
+ Также доступно несколько параметров, которые можно изменить только вручную в файле конфигурации doublecmd.xml.
2.12.1. Файловые операции > Поиск файлов
@@ -865,13 +875,13 @@
Состояние главного окна – Размер и положение окна приложения. Вкладки каталогов – Список вкладок, открытых в левой и правой панелях. Историю поиска/замены – История поиска файлов (кроме масок имён файлов, смотрите ниже), история масок в инструменте группового переименования и история поиска и замены текста: поиск по содержимому файлов, просмотрщик, встроенные редактор и инструмент сравнения файлов, поиск и замена в настройках избранных каталогов и панели инструментов. Также сохраняется состояние параметров поиска текста (С учётом регистра, Регулярные выражения и Шестнадцатеричное) для каждой записи. Историю поиска/замены – История поиска файлов (кроме масок имён файлов, смотрите ниже), история масок в инструменте группового переименования и история поиска и замены текста: поиск по содержимому файлов, просмотрщик, встроенные редактор и инструмент сравнения файлов, поиск и замена в настройках избранных каталогов и панели инструментов. Также сохраняется состояние параметров поиска текста (С учётом регистра, Регулярное выражение и Шестнадцатеричное) для каждой записи. Историю каталогов – Список всех посещённых каталогов (смотрите примечание ниже). Историю командной строки – Команды, использованные в командной строке. Историю масок файлов – Double Commander сохраняет общую историю использованных масок файлов для нескольких инструментов: поиск файлов, фильтры в синхронизации каталогов и распаковке архивов, команды выделения группы файлов и снятия выделения.
- Максимальное количество записей в истории ограничено 50.
- Примечание об истории посещённых каталогов: В течении сессии Double Commander хранит в памяти до 255 посещённых каталогов (тем не менее при закрытии программы будут сохранены только последние 50 записей). Вы можете изменить количество записей истории во всплывающем меню при вызове команды cm_DirHistory (по умолчанию 30, смотрите атрибут Count в теге <DirHistory>), однако при использовании древовидного меню будет показана вся доступная история.
+ Максимальное количество записей в истории по умолчанию ограничено 50 (смотрите атрибут MaxStringItems в теге <History>).
+ Примечание об истории посещённых каталогов: В течении сессии Double Commander хранит в памяти до 255 посещённых каталогов, тем не менее при закрытии программы количество сохраняемых записей будет ограничено значением MaxStringItems. Вы можете изменить количество записей истории во всплывающем меню при вызове команды cm_DirHistory (по умолчанию 30, смотрите атрибут Count в теге <DirHistory>), однако при использовании древовидного меню будет показана вся доступная история.
Примечание: Шаблоны поиска не относятся к истории и сохраняются отдельно (в файле конфигурации doublecmd.xml). Для управления списком шаблонов вы можете использовать инструмент поиска файлов.
Вы можете выбрать, как будет выглядеть список разделов настроек:
@@ -884,7 +894,7 @@
2.16. Быстрый поиск/фильтр
Этот раздел содержит настройки инструмента быстрого поиска/фильтра. Быстрый поиск используется для поиска по текущему содержимому файловой панели, быстрый фильтр скроет все имена файлов, не соответствующие условиям.
- 
+
Точное соответствие имени:
Начало (имя должно начинаться с набранных символов) – означает, что набранный текст будет соответствовать маске "текст*", где "*" – любое количество любых символов. Эти опции можно изменить на лету непосредственно в панели быстрого поиска/фильтра. Также вы можете переключаться между поиском и фильтром.
Настройки:
+ Игнорировать диакритические знаки и лигатуры – позволяет упростить использование быстрого поиска/фильтра: при поиске Double Commander заменит буквы с диакритическими знаками и лигатуры на буквы латинского алфавита (таблица распространённых символов содержится в исходном коде программы). Скрывать панель фильтра, когда она не в фокусе – Панель быстрого поиска/фильтра будет автоматически скрыта, как только вы переместите фокус в файловую панель. В кратком режиме скрытие панели работает некорректно, поэтому опция игнорируется, пока не будет найдено подходящее решение. Сохранять настройки, изменённые через панель фильтра – По умолчанию все параметры, которые были изменены в панели быстрого поиска, будут сохранены в памяти только до закрытия программы, опция позволяет изменить такое поведение.
@@ -939,7 +950,11 @@
- 2.19. Значки
+ 2.19. iCloud
+ Только macOS. В этом разделе настроек перечислены установленные приложения, автоматически создающие папки на диске iCloud: вы можете выбрать папки приложений, которые будут доступны в виртуальной папке iCloud.
+
+
+ 2.20. Значки
Первый параметр включает отображение значков типов файлов слева от имени:
@@ -948,7 +963,12 @@
Только стандартные – Будут отображаться только значки, перечисленные в файле pixmaps.txt, и значки из настроек файловых ассоциаций. В этом случае вы можете использовать значки только из темы значков Double Commander (смотрите каталоги pixmaps/dctheme/XxX/mimetypes в папке программы) или укажите полное (с путём) имя файла. Создание темы значков описано в FAQ. Не показывать значки.
- Показывать оверлейные значки (например, для ярлыков) – Если отмечено, Double Commander будет показывать оверлейные значки, например, стрелки для LNK-файлов и ссылок.
+ Показывать оверлейные значки (например, для ярлыков) – Если отмечено, Double Commander будет показывать оверлейные значки, например, стрелки для LNK-файлов и прочие наложенные эмблемы и метки:
+
+ Windows: Эмблемы из настроек операционной системы и сторонних приложений (например, системы контроля версий или локальные каталоги облачных хранилищ). Linux и другие Unix-подобные системы (кроме macOS и Haiku): Эмблемы RabbitVCS (если доступно) и эмблемы из подсистемы метаданных GIO/GVfs (как в Nautilus, Caja, Thunar, PCManFM и других поддерживающих).
+ Эмблема символьной ссылки и дополнительная эмблема битой/висячей ссылки будут отображаться в любом случае.
Затенять значки скрытых файлов (медленнее) – Если отмечено, Double Commander будет показывать значки скрытых файлов с уровнем прозрачности 50%.
Отключить загрузку специальных значков – Вы можете отключить загрузку специальных значков (оверлейные значки, значки из EXE/LNK-файлов) для указанных каталогов и их подкаталогов, просто перечислите их через точку с запятой ";" без пробелов.
Размер значков – Вы можете выбрать один из следующих размеров:
@@ -963,7 +983,7 @@
Примечание: В Unix-подобных системах Double Commander в первую очередь будет использовать системную тему значков, если каких-то значков не существует, то DC будет использовать свои собственные.
- 2.20. Список исключений
+ 2.21. Список исключений
Исключение указанных файлов и папок (один на строку): они не будут отображаться в панелях.
@@ -978,11 +998,11 @@
Для включения и выключения этой функции вы можете использовать команду cm_SwitchIgnoreList, добавьте кнопку на панель инструментов или сочетание клавиш.
- 2.21. Архиваторы
+ 2.22. Архиваторы
Подробнее ознакомиться с настройкой и использованием можно на странице справки Работа с архивами.
- 2.22. Подсказки
+ 2.23. Подсказки
В этом разделе содержатся настройки всплывающих подсказок при наведении указателя мыши на файл.
Показывать всплывающие подсказки в файловой панели – включает возможность использования подсказок.
@@ -1023,7 +1043,7 @@
На изображении в начале описания раздела вы можете видеть пример всплывающей подсказки с плагином textline.wdx, который показывает содержимое выбранных строк текстового файла (в данном случае первой, второй и третьей строк), выбран режим Объединить подсказку DC и системную, сначала системная.
- 2.23. Файловые ассоциации
+ 2.24. Файловые ассоциации
Этот пункт открывает окно настроек файловых ассоциаций. Все ассоциации сохраняются в файл extassoc.xml.
Здесь можно настроить ассоциации файлов с различными программами, а также задать команды или скрипты для выбранных типов файлов. Указанные команды будут добавлены в контекстное меню файлов. Также Double Commander позволяет просто задать (или заменить) значки для типов файлов, не добавляя какие-либо действия.
@@ -1041,7 +1061,7 @@
file – любой файл; folder – любой каталог; default – используется, когда для расширения не существует ассоциации. default – используется, когда для расширения не существует внутренней ассоциации (только для действий "Open", "View" и "Edit", смотрите ниже).
Вставить – добавляет новое расширение в текущую позицию в списке.
Добавить – добавляет новое расширение в конец списка.
@@ -1081,12 +1101,12 @@
<?command?> – запускает "command" в оболочке системы и подаёт вывод на команду выше.
Как минимум, вы должны указать имя файла, обычно %p или %p0 для файла под курсором.
- Путь запуска – каталог запуска команды. Этот каталог станет рабочим каталогом запускаемой программы и если у вас нет необходимости явно указать его, то просто оставьте это поле пустым: в этом случае рабочим каталогом будет текущий каталог активной файловой панели (обычные файлы) или системный каталог для временных файлов (файлы из архивов и WFX-плагинов). Здесь мы можем использовать переменную %D, %d или переменные окружения.
+ Путь запуска – каталог запуска команды. Этот каталог станет рабочим каталогом запускаемой программы и если у вас нет необходимости явно указать его, то просто оставьте это поле пустым: в этом случае рабочим каталогом будет текущий каталог активной файловой панели (обычные файлы) или системный каталог для временных файлов (файлы из архивов и WFX-плагинов). Здесь вы можете использовать переменную %D, %d или переменные окружения.
Все доступные действия отображаются в контекстном меню в подменю "Команды":
- 2.23.1. Файловые ассоциации > Файловые ассоциации (дополнительно)
+ 2.24.1. Файловые ассоциации > Файловые ассоциации (дополнительно)
Предлагать добавить в файловые ассоциации файл под курсором (если ещё не включен) – При открытии настроек файловых ассоциаций будет предложено добавить тип с расширением файла под курсором (если оно не найдено в уже существующих типах). Это быстрый способ добавить действие "Открыть с помощью": Double Commander предложит вам указать имя типа и исполняемый файл, всё остальное будет сделано автоматически.
Расширенное контекстное меню – позволяет добавить некоторые пункты в подменю "Команды":
@@ -1110,11 +1130,11 @@
Также вы можете применить выбранный способ к уже добавленным путям.
- 2.24. Избранные каталоги
+ 2.25. Избранные каталоги
Подробнее ознакомиться с настройкой и использованием можно на странице справки Избранные каталоги.
- 2.24.1. Избранные каталоги > Избранные каталоги (дополнительно)
+ 2.25.1. Избранные каталоги > Избранные каталоги (дополнительно)
В этом разделе вы можете выбрать, как будет установлен путь и целевой путь:
diff --git a/doc/ru/configxml.html b/doc/ru/configxml.html
index 95f37273..3e33ffb7 100644
--- a/doc/ru/configxml.html
+++ b/doc/ru/configxml.html
@@ -40,12 +40,12 @@
Файл doublecmd.xml может быть расположен в разных местах:
- Домашний каталог пользователя.
- - Каталог программы, обычно в случае использования как портативной версии.
+ - Папка "settings" в каталоге программы, обычно в случае использования как портативной версии.
- Мы можем задать каталог с помощью параметра командной строки при запуске приложения.
Подробнее узнать про параметр командной строки --config-dir можно по этой ссылке.
Расположение задаётся в настройках: Настройки > Параметры... > выбираем в дереве > устанавливаем параметр Месторасположение файлов конфигурации.
-
+
Ещё один способ быстро выяснить, где находится doublecmd.xml текущего экземпляра Double Commander, это использовать меню избранных каталогов. В конце его имеется дополнительный раздел под названием "Специальные каталоги", далее выбираем "Каталог Double Commander..." и "%DC_CONFIG_PATH%". Здесь мы найдём doublecmd.xml, который приложение использует в данный момент.
(наверх)
@@ -151,10 +151,42 @@ 3. Параметры, изменяемые вручну
Встроенный редактор и инструмент сравнения: если ничего не выделено, в диалоге поиска и замены будет использоваться слово под курсором (True) или текст из истории поиска (False). По умолчанию True. |
|
+ "Внутри" сжатого файла мы можем выполнять некоторые минимальные базовые функции, такие как просмотр файла, копирование его в другую панель и некоторые другие.
@@ -697,7 +697,8 @@ 
+ 
+ 
+ 
@@ -2524,9 +2553,9 @@ 
), including search with content plugins. The default value is "*" (all files).
@@ -814,7 +841,26 @@ 
@@ -1108,6 +1154,18 @@ 
