Terminals

The Terminals tool displays an ordered list of thumbnails for each currently connected server and terminal. The terminals belonging to each server always appear immediately after it in the ordering, otherwise servers and terminals can be reordered at will. Terminals can also be hidden, in which case their thumbnails do not appear in the list. Server thumbnails are never hidden.

The Terminals tool is not searchable and is never the active tool. Within the tool, the thumbnails belonging to the active terminal and active server are highlighted in a different color. The Terminals tool can be configured to autoraise itself whenever the active terminal or active server changes. Further global settings for the tool are located under the Appearance/Terminals Tool category, but many settings throughout the application affect the Terminals tool in some way. Via global settings, nearly any action can be configured to run on a double-click, Control-click, Shift-click, or middle-click of a thumbnail.

Some commonly used actions with bindings in qtermy's compiled-in default keymap (your keymap may differ) are:

The captions displayed on thumbnails, as well as their tooltips, are configurable via global settings. The icon image displayed in server thumbnails is normally derived from the icon server attribute but can be set to a fixed icon in the Server settings for the server or by using Server→Set Icon. The icon image displayed in terminal thumbnails is normally derived from the icon autoswitch rules but can be set to a fixed icon in the Profile settings or by using Terminal→Set Icon. Additional "indicator" icons may be shown in the terminal thumbnail depending on the state of the terminal.

Picture of Terminals tool with three servers connected and four terminals visible.

Example of a typical Terminals tool with three servers connected.

The nearby figure shows the Terminals tool in a typical situation. The first thumbnail is the server thumbnail for the transient local server, displayed with a "desktop" icon to indicate that the server runs within the same desktop session as qtermy. The next two thumbnails are terminals that belong to the transient local server, one of which is the active terminal, other of which has scroll lock enabled. Next is the server thumbnail for the persistent user server followed by one terminal thumbnail in which a text editor is running. Note that the persistent user server has a second terminal which is currently hidden; this is indicated by the number in parentheses on the server thumbnail. Finally, a third server connection has been established to the root user's persistent user server, which has one terminal running on it.

The Manage Terminals window provides another view of the same information displayed in the Terminals tool.

Thumbnails can be dragged with the mouse to reorder them, but note that terminals must always go after their parent server. Dragging a thumbnail to a text editor or onto a terminal viewport will paste the UUID of the server or terminal. Dropping text onto a terminal thumbnail will paste the text into the terminal. Dropping a file:// URL onto a thumbnail will either paste the text of the URL or upload the file itself to the server. Configure this behavior using ServerFileDrop, TerminalLocalFileDrop, and related settings.