Worker file manager

1. Directory list view

1.1. Introduction

Worker uses a two-pane approach for displaying directory content (also known as an orthodox file manager). Each of both sides supports several modes for showing different kind of information (directory mode, information mode, text view mode, ...).

One side is always active or source of an operation, while the other side is inactive or destination of an operation. The active panel is indicated by a red list view bar on top of the list view area (the colors can be configured). Switching sides is done by clicking on the corresponding area or by pressing TAB in the default configuration.

1.2. Directory mode

The directory list view (directory mode) is the main view for browsing directory content. The current directory name is shown in the editable path field at the bottom of the list view. The window title also contains the path for the active side.

The visible columns can be configured and usually contains the file name, file size, permissions, and file type information. The width of a column is dynamic by default but can be changed by moving the mouse in between two headers and clicking on the header separator. Double-clicking it will change back to dynamic width.

By clicking in the header, the sort mode can be toggled.

1.3. List view bar

The list view bar on top of each side (above the list view) displays status information about the current mode. For the directory mode this includes the following information: The status string consist of the following elements: The first character stands for the sort mode currently used to sort the files and directories (N = sort by name, S = sort by size, T = sort by modification time, ...). The next character (if visible) indicates that the entries are reverse sorted. The third character "H" indicates (if visible) that hidden files are not shown. At fourth position an asterisk indicates an active filter.

The following text shows the name of currently active mode of the corresponding area below the list view bar. The most important mode is the "directory mode" which list files of any directory. Other modes are the "information mode" for displaying detailed information about an entry, the "show image mode" for displaying images in the area below, and the "text view mode" for displaying the content of the active entry.

1.4. File name prefixes

In front of file names a special character is used to differentiate between different kind of files:
/Directory entry
~Symbolic link to a directory
*Executable file
@Symbolic link to a file
!Broken symbolic link (target does not exists or is inaccessible
-character device
+block device
|pipe (named fifo)
 regular file

1.5. Virtual directories

The virtual dir mode introduced in Worker 3.0.0 also supports viewing so-called virtual directories. Those directories can be search results which can be "panelized". You can work with those directories just like regular directories, move files around, execute external program, etc. The file names shown in the list view are paths relative to the base directory (which is the common prefix of all entries in the virtual directory).

A virtual directory can be identified by the path name, it does not start with a slash but some other identifier. If it comes from search results, it starts with "search...".

You can read more information at the virtual directories page.

1.6. Navigation

In the default configuration, the navigation through the directories is done with the cursor keys. The active entry is highlighted in a different color and can be moved by pressing the up and down keys.

The right cursor key enters the directory of the active entry if it is a directory, while the left cursor key changes to the parent directory of the current directory.

When navigating a virtual directory (for example, from search results or the path jump dialog), the left and right keys behaves slightly different. Pressing the right cursor key will refine the virtual directory to contain only those entries that are in the same base directory as the active element. The left cursor key will go to the parent directory but staying in the virtual directory if possible. This method allows to navigate through virtual directories even if only files are visible (from multiple, different directories).


This picture shows the panelized path jump entries. When pressing the right cursor key, the view will change to the content shown in the next picture:

Only those elements are visible which start with the "home" directory. Since the resulting elements are all located in the "Downloads" directory, the new virtual directory directly shows this directory as a path.
When pressing the left cursor key, Worker will not change into "/home/ralf" which would be the direct parent directory, but instead change back to the previous virtual directory which contains all elements.

Some special navigation features are only issued by the double click action of the file type for the current entry. This includes changing into archives by using the VFS, or directly entering directories in a virtual directory. To use this action, press the Enter key or double click on the entry.

1.7. Breadcrumb navigation

The breadcrumb navigation bar makes it easy to access any part of the current directory hierarchy directly with one mouse click. Every path component is represented by a separate button.

When switching to the parent directory, the deepest path remains visible. It is possible to enter any sub-directory again by just clicking on the corresponding button.

The navigation bar can be enabled or disabled in the directory mode configuration (accessible by clicking on the "O" button).

1.8. Directory mode options

In the configuration dialog of the directory mode allows to modify settings specific to this mode. It includes settings for:

The configuration can be accessed by right-clicking on the list view bar and selecting configure, or by clicking at the "O" button.

1.9. Info line

The info line below the list view can be used to show information about the current entry. The content of that line is configurable bz either simple flag replacement, or by using the LUA scripting language to generate the text to view. Example uses are to show the name and size of the entry and the destination, if the current entry is a symlink.

1.9.1. Flag replacement without LUA

If LUA is disabled or not available, the string entered in the configuration will be parsed and some flags are replaced, similar to the external command.

The following table contains all available flags and their meaning:

{f}file name
{F}file name with full path
{filetype}file type
{filesize}file size in Bytes
{symlink_dest}destination of symbolic link (or empty)
{user}the user name of the owner of the file
{group}the group name of the owner of the file

The default value is:

{f} {symlink_dest} ({filesize} bytes)
which will look like:
foobar  (123 bytes)
or for a symlink:
foobar ../some/other/target (123 bytes)

1.9.2. LUA mode

For more advanced text generation, the LUA mode can be used. When enabled, the string is evaluated with LUA with some variables predefined and the returned string will be shown. By using conditions, the text can be modified more flexible then without LUA.

The following table contains all available variables inside the LUA command and their meaning:

basenamefile name
fullnamefile name with full path
filetypefile type
filesizefile size in Bytes
symlink_destdestination of symbolic link (or empty)
is_symlinkboolean variable, true if entry is a symlink, false otherwise
userthe user name of the owner of the file
groupthe group name of the owner of the file

The default value is:

if ( is_symlink ) then
  return basename .. " -> " .. symlink_dest .. ": " .. filetype;
  return basename .. ": " .. filetype .. " (" .. filesize .. " bytes)";
which will look like:
foobar: text file (123 bytes)
or for a symlink:
foobar -> ../some/other/target: text file