QtCommander

file manager

Files operations

Below please find the list of all supported files operations in QtCommander:

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.

File List view operations

  • Renaming - uses key shortcuts: Shift+F6 and F2 which makes possible to rename item using edit box shown on item position,
  • Filtering the list - uses shortcut Ctrl+F and makes possible to filter the list with given templates (supports regular expressions and wildcards),
  • Quick search - uses shortcut Ctrl+S and makes possible to quick search given item,
  • Marking - below list of possibilities how to mark items:
    • by shortcut (Insert) - marks one item and moves cursor one position down,
    • by mouse - marks range of items (pointed by mouse),
    • by templates - makes possible to enter template for matching items

Main menu

Here you can find following options:

  • menu File:
    • Open directory - lists selected directory in current panel,
    • Open file - try to open internal view for selected file,
    • Open archive - opens selected archive in current panel.
  • menu View:
    • Show/Hide tool bar - shows or hides tool bar,
    • Show/Hide button bar - shows or hides bottom bar,
    • Show/Hide main menu - shows or hides main menu,
    • Show/Hide terminal - shows or hides terminal window,
    • Show/Hide command line - shows or hides command line,
  • menu Settings:
    • Configure QtCommander - shows main window of settings,
    • Configure shortcuts- shows window to configration of shortcuts,
    • Configure toolbar - shows window to configration of tools bar,
    • Configure viewer - shows setting for internal viewer
  • menu Tools:
    • FTP sessions manager - shows window of FTP sessions manager,
    • Find file - shows dialog for advanced find file/directory,
    • Bookmarks - shows list of bookmarks, defined by user and placed in left top corner of current panel,
    • Devices - shows list mounted/unmounted drivers placed in left top corner of current panel,
  • menu Tabs:
    • Open new tab - opens new tab (and activates it), on end of list all opened, with defauld directory: /home
    • Close current tab - closes current (active) tab,
    • Duplicate current tab - duplicates current tab (doesn't active it), on end of list all opened
  • menu Help:
    • Help - shows window with help,
    • About QtCommander - shows information about this application (version, authors, license),
    • About Qt - shows information about current version of Qt used by application,

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.

Navigation on the list view

  • Up/Down - moves up/down highlighted bar on the list.
  • Home/End - jumps to first/last item on the list.
  • PageUp/PageDown - jumps to first/last item on next/previous page of the list.
  • Left/Right - moves left/right content of panel.
  • Backspace - makes possiblity to go up in directory structure (for archives listed on top level makes leaving of archive and for remote location makes disconnection).
  • Ctrl+Backspace - causes leaving remote location or opened archive and listing last opened directory from local subsystem.
  • Ctrl+Shift+N - acts the same like option linked with key shortcut Ctrl+Backspace.
  • Ctrl+Home - opens user's home directory.
  • Ctrl+/ - opens root directory (local subsystem) in current tab.

Navigation by tabs

  • Ctrl+Tab - switches tab forward.
  • Ctrl+Shift+Tab - switches tab backward.
  • Ctrl+N - creates new tab in current panel (placed on end of list opened tabs) with listed /home directory.
  • Ctrl+W - closes current tab.
  • Ctrl+Alt+D - duplicates current tab and puts it on end tabs list in current panel.
  • Alt+1..9 - switches to tab with selected number (1-9) in current panel.

Marking

  • Insert - marks/un-marks currently highlighted item and additionally move highlighting one item down.
  • Asterisk - causes reverse of selection for all of items on the list view.
  • Plus/Minus - marks/un-marks items of list view using given template.
  • Ctrl+A - marks all items (including directories - depends on option in configuration file).
  • Ctrl+E - marks all items matching to file extension of currently highlighted item.
  • Ctrl+Shift+A - un-marks all items (including directories - depends on option in configuration file).
  • Ctrl+Shift+E - un-marks all items matching to file extension of currently highlighted item.

Files/directories/archives operations

  • Space - starts weighing highlighted directory, when will finish then its weight is showing inline in column calling "Size".
  • Enter/Return
    • if directory is highlighted then tries to open it,
    • if file is highlighted then tries to open external viewer that is associated with file mime,
    • if highlighted file is executable then tries to execute it.
  • F2 - acts the same like option linked with key shortcut Shift+F6 (rename file showing editbox in place of item).
  • F3
    • if directory is highlighted then tries to open it,
    • if file is focused then tries to open internal viewer that is related with matches to file mime
  • Ctrl+R - refreshes current directory in current tab.
  • Ctrl+Left/Right - opens currently highlighted directory in left or right panel, respectively.
  • F4 - makes possiblity to edit highlighted file in internal viewer and if this is not possible then shows properly message.
  • Shift+F4 - shows dialog, that make possiblity to create new empty file(s).
  • F5 - shows copying dialog, that makes possiblity to copy files or directories to defined location (default it is path from opposite active tab).
  • F6 - shows moving dialog, that makes possiblity to move files or directories to defined location (default it is location from opposite active tab).
  • Shift+F6 - makes possiblity to rename highlighted file or directory - showing editbox on item position.
  • F7 - shows dialog, that makes possiblity to create new directory or even structure of directories.
  • F8/Delete - shows dialog, that makes possiblity to remove files or/and directories (all marked or only one highlighted)
  • Ctrl+L - shows dialog, that make possiblity to create symbolic or hard link (also makes able to create multiple links after marking of the source files/directories).
  • Ctrl+M - shows dialog, that make possiblity to modify target of symbolic link.
  • Alt+F5 - shows dialog, that makes possiblity to create new archive(s).
  • Alt+F6 - shows dialog, that makes possiblity to move selected files/directories to new archive.

Additional possibilities

  • Ctrl+S - shows quick searching dialog (bar placed at bottom of list) uses to searching items on the list view.
  • Ctrl+F - shows filtering dialog (bar placed at bottom of list) uses to filtering items on the list view.
  • Alt+Down - shows history of visited locations (flicking out list in path view).
  • Shift+Tab/Alt+Up - moves focus to the path view, pressing "Tab" causes go back to list view.
  • Ctrl+Alt+N - shows new connection dialog (in this moment handles only FTP protocol).
  • Ctrl+D - shows drives menu (including ability of mounting and unmounting each device).
  • Alt+F7 - shows dialog, that makes possiblity to search file/directory according to given template in local subsytem or inside opened archive.
  • Ctrl+\ or Ctrl+B - shows bookmarks menu (paths to file subsystems).
  • Menu - shows context menu for highlighted item.
  • Shift+F2 - acts the same like option linked to key shortcut "Menu".
  • Ctrl+Q - quits of application.
  • F1 - shows help window.
  • (left) Alt+Enter/Return - shows properties dialog for highlighted item or all selected items.

Navigation by mouse

Below please find the list of options contain brief description each of them.

  • single click of left mouse button made highlight item, over that mouse cursor is placed (item will be focused),
  • double click of left mouse button made run program/script or, depends on type of clicked item, will list directory or will open file in external viewer,
  • holding Shift key and single click left mouse button on selected item, made marking items placed between last highlighted and clicked item (inclusive),
  • single click of right mouse button made showing context menu with option related to clicked item.

Context menu contains following options:

  • Open (opens sub menu with options like below)
    • Open - opens file in external viewer or lists directory in current panel,
    • Open with - opens file in selected viewer,
  • View - view file in internal viewer or lists highlighted directory,
  • Edit - edit file in internal editor (option available only for files and in local file system),
  • Create new (opens sub menu with options like below) (option available only in local file system and for remote location)
    • Text view - creates new empty file,
    • Directory - creates new directory or structure of them,
  • Rename - makes possible to rename highlighted file/directory by edit box placed onto item position,,
  • Delete - makes possible to remove highlighted file/directory or their marked group,
  • Copy to - makes possible to copy highlighted file/directory or their marked group to selected location,
  • Move to - makes possible to move highlighted file/directory or their marked group to selected location,
  • Extract to - makes possible to extract highlighted archive or their marked group to selected location (option available after click in archive)
  • Extract here - makes possible to extract highlighted archive or their marked group to current directory (option available after click in archive)
  • Add to archive - makes possible to add highlighted file/directory or their marked group to opened in opposite panel archive (option available only in local file system)
  • Move to archive - makes possible to move highlighted file/directory or their marked group to opened in opposite panel archive (option available only in local file system)
  • Select/Unselect (opens sub menu with options like below)
    • Select all - marks all files (and directories - depends on option) in current list,
    • Unselect all - un-marks all files (and directories - depends on option) in current list,
    • Select with the same extension - marks all files with the same extension like clicked item in current list,
    • Unselect with the same extension - un-marks all files with the same extension like clicked item in current list,
    • Select using template - marks all items according to entered template
    • Unselect using template - un-marks all items according to entered template
  • Properties - shows window with properties for highlighted file/directory or their marked group. Here is possible to edit all shown properties.
  • Make link(s) - makes possible to create link(s) for highlighted file/directory or their marked group (option available only in local file system)
  • Edit symlink - makes possible to edit symlink for highlighted item (option available after click in symlink in local file system)