Listing of archive and directory.

When program is starting this function is running as one of first. If user opened before many tabs then
it may slow down the running of application a bit. The list view of each opened panel and each opened
tab(s) is filled by items describing the files and directories present in given (opened) directory, archive or remote location (ftp). If path points out to remote location then if connection is not anonymous (no password required) will be open also connection dialog, where user needs to put the credentials required to connection with server.
When any of item on files list view has focus then activities like: pressing Enter/Return/F3, double click, choosing option "Open" from context menu makes that QtCommander will try to change current directory in active tab on selected one.
The same effect, so change current path can be achieved by change string in path view (placed on bottom each of panel) change will be performed after user put slash ("/") at end of string.
Last option of change current path is selecting any of path from history path view itself. Additionally you can change current directory in active tab using option from menu: "Actions -> Open -> Open directory"

This operation works in all supported files systems (local, remote and archive).

Copying.

Invoked (default) by F5 key shortcut or properly button placed in bottom bar, available is also
option in context menu. Operation is performed in two steps.
Firstly is shown input dialog with edit box, where user can points out target location
(by default this is path from opposite active tab, including history of paths) and with
additional options like:

saving file permission,

weighing items before operations (thanks that is showing progress bar),

option accepting overwriting automatically if copying will meet collision, so target file with the same name.

Second step this is real copying. During this operation is shown progress dialog. Here are shown detailed statistics about copying. User will find here following information:

local progress in percent (local because is related with single copying file),

global progress in percent (global because is related with all weighed previously items),

amount of files that have been copied comparing to all counted previously

amount of directories that have been copied comparing to all counted previously,

current time (in seconds) what operation takes,

speed of transfer (bytes/KB/MB per second),

estimated time for copying operation.

Please note that last two information will be shown only if operation will take more than 1 second.
User is able to stop copying by pressing "Cancel" button or just closing copying dialog. He can also set option which makes that copying dialog will be automatically close after operation will finish.

If on first dialog user doesn't turn on option for overwriting target files, then when collision happens (copying met file with the same name - for source and target) will be shown "Overwriting dialog" asking if target file should be replaced.
Here is available many options (buttons) like following: "Yes", "No", "If different size", "Rename", "All", "Update all", "No overwrite", "Cancel".

Operation is running "in background"". It means that during copying, GUI is neither block nor freeing. Also main window is not blocking, so it means that user can minimize progress dialog and take care other things.

After copying finished, both files list views are updated. This operation works in all supported files systems (local, remote and archive). In case of remote (ftp) is not possible to copying directories, which are not empty.

Moving.

Invoked (default) by F5 key shortcut or properly button placed in bottom bar, available is also
option in context menu. Similar to copying this operation also is performed in two steps.
Everything looks like in copying operation, skipping that after operation will finish then items from source location are removed and items put into opposite files list view (only if user selects default path pointing out to path in opposite tab).
This operation works in all supported files systems (local, remote and archive). In case of remote (ftp) is not possible to moving directories, which are not empty.

Removing.

Invoked (default) by F8 key shortcut or Delete or properly button placed in bottom bar, available is also option in context menu. There is possible real removing of files and directories or in safe way, so selected files and directories are moved to special directory calling internally "Trash".
The way of removing one can set using configuration dialog of application. Operation runs in two steps.
In first user is asking - if he/her is sure that need to remove selected items. Here also can turn on/of option making that items will be weighed before operation will start. By default this is set.
Second step is real removing. If among of items to remove exists directory, then application check if it is empty and if doesn't then user is asking if directory should be remove by recursive.
After user confirms application try to remove selected directory. During removing is shown progress of operation. On dialog user can find following information:

total progress in percent,

amount of removed files comparing to all counted previously,

amount of removed directories comparing to all counted previously,

current time (in seconds) what operation takes,

Please note that progress dialog shows information only if user selected weighing before removing started. If operation will finish with success, then file list view is update, so items are removed
from view. This operation works in all supported files systems (local, remote and archive). In case
of remote (ftp) is not possible to removing directories, which are not empty. Please note that in
case of some archive types, this archive can be repack.

Creating and editing links.

In this function is possible to create one or group links. It depends on how much items user selects.
Creating of link is invoked (default) by Ctrl+L key shortcut or properly button placed in bottom bar, available is also option in context menu. On input dialog needs to point out target path (by default here is placed path from opposite active tab). By default will be be crated symbolic link, but setting option edit box user can also create hard link.
After user press OK, application will try to create links. If operation will finish with success then target file list view will be updated (only if user didn't change target path).

User can involve editing of symbolic link in two ways. On by key shortcut (Ctrl+M) or by option from context menu. After invoking edit of link is shown dialog with edit box, initiated by current target path of symbolic link. Here user can modify it of put new one. After pressing OK, if no errors then on file list view is updating size of symbolic link.

Please note that both operation are available only for local subsystem.

Creating directories.

This often using activity may perform by key shortcut (default) F7. or using button placed
on bottom bar, available is also option in context menu. After calling the operation is shown
dialog with edit box (including history of used names), where used can enter name new directory. Using this dialog is possible to create not only single directory, but also

directory structure, like dir/subdir

couple directories, entering their names separated by pipe: "|"

couple directory structures, like dir/subdir|second_dir/second_subdir

All is described in tool tip, showed when user will move the mouse cursor over edit box.
Below edit box is placed option, after checking user will be changed current directory on recently created (using this dialog). After pressing OK, application will try to create requested director(y/ies). If all will pass with success then properly list view will be updated with new entries.
Creating directories is possible in following subsystems: local and remote (FTP).

Renaming files and directories.

This activity may call in two ways. First one by moving operation (running by key shortcut F6),
second one is use so-called quick attribute change - called by key shortcut Shift+F6.
After using this method on place of item is shown edit box, where user can enter new or change current name.
After pressing Enter key, application tries to rename item. If activity will finish with success then item is updated on file list view.

Changing properties.

Option is intended to change attributes of file/directory like below:

name

modified time

last access time

permission

owner

group

There is only one way to involve this operation - by calling properties dialog from context menu on list view (by RMB or properly key shortcut like: "Menu").
Properties dialog works in so-called safe mode, so protects user before accidentally change of attributes and in order of this requires confirmation by setting additional "check box" for every property.

Called properties dialog is related with all selected before files and directories, so after selecting couple of files in field "Name" user can find all these items (in combo list).
After user selects in this combo one item all properties (time, permissions, owner, group) in dialog are updated for this item.
In case selecting couple items in filed name, by default here is placed fake item called "ALL SELECTED", and every change of attributes will be affected on all selected items.
For directory working recursive operations, so change of attributes. In order of this user needs to check properly field on dialog.

Additionally user can select if he want to change attributes for category of items, so only for files, or for directories or for both.

After user press OK button, application will try to apply changes attributes for all selected items. If operation will finish with success then will be updated file list view.

Marking.

Application gives possibility to marking items (files and directories) in several ways. They are available by key shortcuts and by context menu. In context menu user will find following method of marking items:

marking and un-marking all items

marking and un-marking items with the same extension

marking and un-marking items using template

Following key shortcuts are intended to this operation:

Plus shows dialog with edit box (including history templates used to marking). User can pass couple templates separating them by pipe ("|")
All is described in tool tip, showed when user will move the mouse cursor over edit box,

Minus works similar like above, only is used to un-marking items,

Ctrl+Plus/Minus - marks/un-marks all items in current active tab,

Alt+Plus/Minus - marks/un-marks all items in current active tab with the same extension like focused,

Asterisk (*) - makes inversion of current marking of all items on list view,

Insert - marks single item on the list view and moves highlight on next item.

Need to add here that group marking depends on settings in configuration and by this option
might be marked only files skipping directories or all (files and directories).
User can mark items also by mouse, marks range of items. I described in chapter about
marking of items.
After run marking/un-marking is updated information placed on status bar. User can find
there number of marked items comparing to all and total weight of selected items.
Note that each marked directory weighs 0 bytes, but only if user doesn't weigh it by
Space key shortcut.

Weighing directories.

This operation might be perform in two ways. Namely using properties dialog or by pressing Space
key shortcut, only when highlight is present on directory.
In first case weigh of directory is show in properties dialog.
In second case user will see weigh of directory in column "Size" on place current highlighted item. Second pressing of Space key shortcut just restores previously value of this column,
so "<DIR>".
Using first method user will get more detailed information, because skipping weigh of directory
will be also shown number of files and sub directories which contains weighed directory.

Viewing and editing files.

There is available 5 types of internal viewers, so: for text, for images, binary, video
and sound (mp3, wav, etc.).
File one might view using key shortcut (default) F3 or pressing properly button placed
on bottom bar. User can also use option from context menu.

Return/Enter key shortcut makes open file in external viewer (it is run by xdg-open command), but it happens only if highlighted file is not executable. File view is opened in external window.

Need to add that if will not be matched properly view to opened file then it will be open in binary view (several columns with hexadecimal numbers + ASCII column).
Second important thing is that in case of text file is supported syntax highlighting. This possibility
is available only for source code files in C/C++ and HTML/XML language.

Editing file is possible by F4 key shortcut (default) or by pressing properly button placed on bottom bar. Of course is also available option in content menu.
After user involves this activity is shown the same window like in case of view file. Only one different here is that user can edit file.
In this moment this option is available only for text file. Also here is available syntax highlighting.

Finding.

In order to find file(s) or directory(ies) user should used key shortcut Alt+F7 or press properly button on bottom bar.
To find has been created advanced window with couple tabs, where is possible to match in many aspects the rules of searching.
Searching by name is possible for given template, where user can use wildcards for example "*", what any amount of characters or no character or "?" (one single character).

History of templates is stored in configuration file. Here is also handled case sensitive respects in matching file name to given template.

User can point out starting point (path in local subsystem) for searching. Also list of paths is stored in configuration file. All mentioned is placed in first tab, which is calling "Name and location".

Second called "Content" offers possibility to pass text string which should be placed in searching file. Note. This option is disabled, because doesn't work yet.

On third tab, calling "Attributes", user can set following parameters: time between which file has been created, file size greater than/less than/equal with given (passed in bytes, KB, MG, GB, TB), also select owner and group for searched file(s).
Last tab about the name "Customize" allows to adjust couple searching parameters. Namely

match only defined type of files (all are placed on list)

search recursive (by default turned on)

stop searching after successfully matching defined number of items

All found items are put on the list build with the same columns like main file list view. Additionally here is placed column called "file location".
In any moment user can stop searching, pause it, restore or clean the list with found items. Here is also option which allows to put all found items into file list view placed in tab from active panel.

Finding operation works in local subsystem and in archive (when user is present inside of archive).

Mounting and unmounting.

Operations are related with mass storage, for example disk partitions. After invoking key shortcut (by default Ctrl+D) on left top corner of current panel is shown list contains all devices which are possible to mount. Each name is absolute path where device is mounted.

At the left side is place big dot, and if is green then means that device is mounted, if red then device is not mounted.
Next to each path is shown in brackets capacity and free space (numbers with suffix TB/GB/MB/KB/B) related with mounted disk.
Each entry in this menu has its sub menu with two options, so: "Open" and "Unmount" or "Mount". Choosing option "Open" makes change directory in current panel. Choosing others invokes try of unmounting or mounting, accordingly.

The list of default key shortcuts

Chapter describes all key shortcuts available in main window of application. The shortcuts related with view window are described in another chapter. The review was divided into several sections, by belonging to performing specific tasks. One needs to highlight is below shortcuts are default. Application has possibility to change them by configuration dialog.