Worker file manager

1. Own Command

The "own command" is used to execute external programs. By using flags in command strings, the names of the selected files can be given to those programs. When such an "own command" is started, Worker will replace all flags, execute the resulting string, and wait for the termination of the program. It is possible to put the program into background by pressing the middle mouse button or pressing Escape.

The behavior of this command can be modified by the following options:

• Separate each item
  The defined command will be performed on every item separately.
• Recursive
  The command will be performed on every file in the subdirectories.
• Also use dirs for flag replacement (when collecting recursively)
  When running recusively, onyl files are replaced for flags. If this option is enabled, directories are also used.
• Do not enter directory
  Without this option, the program will be executed in the current directory. If this option is enabled, the working directory will be the root directory instead.
• Use temporary copies for all virtual files used for external programs
  If the current directory is within some archive, a temporary copy will be created to enable external programs to access those files as well. This can be disabled again on a per-flag basis using an asterisk as modifer, see below.
• Flags without path are relative to base dir
  If so-called virtual directories are shown, files can be located in different directories. If flags are used which do not use the complete path but only the basename of an entry, the resulting path would be incorrect. This option makes sure that those flags uses the correct relative path instead. If you need only the basename, you have to disable this option and use the flags with full path to get the complete file name.
• Run in background
  Directly run the program in background, don't wait for termination.
• Start mode
  The program can be started in different ways. Possible options are:
  • normal mode
    The program will be executed as is, no seperate terminal is used. If the program uses terminal for input you should not use this mode because there is no possibility to interact with the program.
  • in terminal
    The program will be executed in a terminal so you can perform interaction.
  • in terminal and wait for key
    Same as before but you have to press Enter after execution. This lets you see the output before the terminal is closed.
  • show output
    After the execution the output of the program will be displayed. The default external program for viewing the output is "xmessage". You can set a different viewer in the corresponding text field.
    The text field must contain the program name (from $PATH or as full path) and the placeholder %s which is replaced with a temporary file name containing the output.
    The corresponding string for the default "xmessage" command is "xmessage -file %s".
  • show output (internal viewer)
    Same as before, but the internal viewer will be used to show the output.

1.1. Flags

The following flags can be used in command strings which will be replaced with the corresponding string. You can press on the "O" button to select the flag from a list of all available flags.

• Flags for accessing the current directory:

  {p}	current path
  {op}	path of other (inactive) side
  {lp}	path of left side
  {rp}	path of right side
  {dp}	destination path (of Drag'N'Drop)

• Flags for accessing the selected files:

  {f}	first selected file or directory without path Only the path relative to the base directory will be used. If this flag is used multiple times, the next selected file will be used.
  {F}	first selected file or directory with full path The complete path will be used.
  {a}	all selected files or directories without path Same as {f}, but all selected files are considered and inserted space-separated.
  {A}	all selected files or directories with full path Same as {F}, but all selected files are considered and inserted space-separated.
  {t}	temporary copy of first selected file A temporary copy of the selected file will be used.

• Flags for modifying the file flags:

  {u...}	files will not be deselected, but are available again for next flag replacement.
  {o...}	replacement considers the opposite side instead of the current side.
  {*...}	do not generate temporary file copies of virtual files (within archives etc).
  {...E}	the replaced file name will be without file extension (not available to temporary copies).

• Additional flags

  {Rs{Infotext}{Defaulttext}}	Opens a dialog and asks for string as a replacement for this flag. The "infotext" will be shown in the dialog as a description. The "defaulttext" is the string already inserted in the text area in the dialog. Both strings can contain flags again.
  {pop 0}	Uses the top entry from the given ScriptOp stack. The entry will be removed from the stack.
  {top 0}	Uses the top entry from the given ScriptOp stack. The entry will remain on the stack.
  {size 0}	Will be replaced with the number of elements in the given ScriptOp stack.
  {vEnvname}	Will be replaced with the content of the given environment variable "Envname".
  {scripts}	Will be replaced with the directory to the Worker scripts directory.

• Generic flag modifier

  {-...}

  Do not quote the flag content and use it as is instead.

  1.2. Additional notes

• You can read more about how flags are being replaced here.