Tasks

The Tasks tool displays the list of tasks which have been run in the application. There are many different types of tasks, some of which are started by calling certain actions. The Tasks tool serves as the central location to view and manage tasks. Tasks come in two flavors: active tasks such as downloads that run to completion on their own and non-active or "long-running" tasks such as port forwards that generally run until explicitly canceled.

The Tasks tool is not searchable but it is navigable, having a current selection that can be moved and acted upon using generic or tool-specific actions. Via global settings, certain actions can be configured to run on a double-click, Control-click, Shift-click, or middle-click of a task. Further global settings for the tool are located under the Tasks/Tasks Tool category.

The Tasks tool can be configured to autoraise itself when a task has started or finished. Individual task status dialogs can also be configured to show and hide themselves automatically. Task status dialogs can be shown manually using Tools→Show Status, from the Tasks tool context menu, or by calling InspectTask. The Tasks tool will not autohide until all active tasks have completed and a configurable brief idle period has passed. Clicking in the Tasks tool will cancel autohide as well. This provides time for the user to observe the task that caused the Tasks tool or task status dialog to pop up.

Tasks can be sorted in ascending or descending order by progress, type, source, destination, start time, and several other fields by clicking a table column header. Drag table column headers to reorder them and use the header's context menu to show and hide individual columns.

Some tasks are considered "background" tasks and will not display a task status dialog automatically, regardless of the AutoShowTaskStatus setting. These tasks include:

• Mount tasks run by a launcher as part of a call to OpenFile.
• Fetch image tasks used to retrieve images for inline display. See termy-imgcat and termy-imgls.
• Run command tasks run by a launcher configured to display program output in a separate dialog box.
• Connection tasks, including tasks launched by batch connections. These display a different dialog box.
• Port forwarding tasks launched automatically as a result of server PortForwardingRules.

Active tasks have a progress bar that updates as the task proceeds to completion. The progress bar for the most recently launched active task is shown in the status bar where the home page link is normally displayed. Long-running tasks are shown with an empty progress bar that never advances.

Some tasks such as download and mount tasks produce an output file or directory on the local machine. This output file can be accessed directly from the Tasks tool or task status dialog in a number of ways: it can be opened using the default launcher, a terminal can be opened to its enclosing directory, or its path can be copied or written to the active terminal.

Some tasks are clonable, which means they can be restarted as a new task with the same parameters as before. Clone a task using Tools→Re-run Task, the Tasks tool context menu, or the RestartTask action.