Skip to content

Hotkeys

Jump to bottom
Igor Malyushkin edited this page Jun 16, 2024 · 4 revisions

This guide is based on versions before 0.1.8!

Main screen

The main screen supports the next hotkeys:

  • Ctrl+N to toggle night mode.
  • Ctrl+O to show the open dialog.
  • Ctrl+S to show the context switch dialog.
  • Ctrl+L to show the logs dialog.
  • Ctrl+C to leave Thymus, a confirmation dialog will be shown.

Confirmation and error dialogs

These dialogs have a message and one or two buttons. If there are two buttons the "Cancel" button is in the focus by default. The Enter key presses a selected button. The Tab key moves the focus between buttons. The Shift+Tab does it backward. The error dialog has only one button.

Any input field

The input field of the open dialog and the working screen support the next:

  • Ctrl+Arrow Left to move the cursor one word to the left.
  • Ctrl+Arrow Right to move the cursor one word to the right.
  • Backspace to delete the character to the left of the cursor.
  • Home, and Ctrl+A to go to the beginning of the input.
  • End, and Ctrl+E to go to the end of the input.
  • Delete, and Ctrl+D to delete the character to the right of the cursor.
  • Enter to submit the current value of the input.
  • Ctrl+W to delete the word to the left of the cursor.
  • Ctrl+U to delete everything to the left of the cursor.
  • Ctrl+F to delete the word to the right of the cursor.
  • Ctrl+K to delete everything to the right of the cursor.

Open dialog

The open dialog does not support any hotkeys from the main screen list. There are other options:

  • Tab to move the focus further among the elements.
  • Shift+Tab to move it backward.
  • Arrow Up, and Arrow Down to move a selection inside the directory tree and both selectors.
  • Enter to either expand any folder or copy a filename to the input field in the directory field.
  • Escape to silently close the dialog.
  • p to move the focus to the Platforms switch (does not work when the focus is on any input field!).
  • e to move the focus to the Encodings switch (does not work when the focus is on any input field!).
  • t to move the focus to the Directory tree (does not work when the focus is on any input field!).
  • l to switch tab left (does not work when the focus is on any input field!).
  • r to switch tab right (does not work when the focus is on any input field!).

Switch contexts dialog

The Arrow Up and Arrow Down keys move the selection up and down respectively. The Enter key switches to a selected context. The Escape key closes this dialog silently.

Logs dialog

This dialog supports only the Escape key to silently exit.

Working screen

This screen supports all the hotkeys of the main screen and additional ones:

  • Ctrl+B to toggle the left sidebar.
  • Escape, and Ctrl+; to close this screen with a confirmation dialog.
  • n to load an additional screen for lengthy outputs explicitly (implicitly it is done by scrolling down).

The input field supports all the default keys and additional ones:

  • Arrow Up, and Arrow Down to move a selection inside the left sidebar up and down respectively if a legacy Tab mode is on. When the Enhanced Tab is on, these hotkeys move the content of the Main output field.
  • Ctrl+Up, and Ctrl+Down to select a previously inserted command from a history list.
  • Tab to accept the completion suggestion from the left sidebar if there is such a suggestion when the Input field is non-empty. If the Input field is empty, it moves the focus to the Main output field.

Selecting and copying the text

To select the content without elements of the Left sidebar use the Ctrl+B combination to hide it.

From the Textual documentation:

Running a Textual app puts your terminal in to application mode which disables clicking and dragging to select text.
Most terminal emulators offer a modifier key which you can hold while you click and drag to restore the behavior you
may expect from the command line. The exact modifier key depends on the terminal and platform you are running on.

- iTerm: Hold the OPTION key.
- Gnome Terminal: Hold the SHIFT key.
- Windows Terminal: Hold the SHIFT key.

Refer to the documentation for your terminal emulator, if it is not listed above.

Clone this wiki locally