Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Usage

Todo.txt TUI is a powerful and flexible terminal-based interface designed to simplify task management. Its customization options allow you to tailor the tool to fit your workflow. Below, you’ll find a comprehensive list of keybindings and actions, organized by category, to help you get started. All actions can be customized in the configuration file to suit your preferences.

Keybindings

Navigation:

  • j: Move down to the next task in the list.
  • k: Move up to the previous task in the list.
  • g: Jump directly to the first task in the list.
  • G: Jump directly to the last task in the list.

Managing Tasks:

  • Enter: Show task in preview.
  • U: Move the currently selected task up in the list.
  • D: Move the currently selected task down in the list.
  • x: Remove the selected task permanently from the list.
  • d: Toggle a task’s status between pending and done.
  • y: Copy the selected task to the system clipboard.
  • I: Input a new task into the list.
  • E: Edit the currently selected task to update its details.

Widget Navigation:

  • J: Jump to the widget located below the current one.
  • K: Jump to the widget located above the current one.
  • H: Move to the widget on the left side of the current one.
  • L: Move to the widget on the right side of the current one.

Filtering and Searching Tasks:

  • Backspace: Apply a filter to display specific categories in the pending or done lists.
  • /: Search for a keyword or phrase within the current list.
  • n: Navigate to the next occurrence of the search term.
  • N: Navigate to the previous occurrence of the search term.
  • h: Clear the current search term and reset the list view.

File Operations:

  • S: Save all current tasks to the todo.txt file.
  • u: Reload tasks from the todo.txt file to update the list with external changes.

Quit:

  • q: Quit Todo.txt TUI and save any unsaved changes.

Task Input Bar

The task input bar allows you to add or edit tasks. Press Enter to confirm the input and save the task, or press Esc to cancel. Additionally, common Bash/Emacs keybindings are supported:

  • Ctrl+w: Delete the previous word.
  • Ctrl+e: Move the cursor to the end of the line.
  • Ctrl+a: Move the cursor to the beginning of the line.
  • Ctrl+k: Delete from the cursor to the end of the line.
  • Ctrl+u: Delete from the cursor to the beginning of the line.

It is also possible to use tab key to autocomplete existing projects, contexts or hashtags.

If mouse support is enabled, clicking the input bar focuses it and moves the cursor to the clicked position. Clicking any other widget while the input bar is focused behaves like pressing Esc and selects the clicked widget.

Copying Text

Press y to copy the active task, as a plain todo.txt line, to the system clipboard. The task is handed over to the terminal emulator with the OSC 52 escape sequence.

To copy an arbitrary part of the screen, hold the left mouse button and drag over it. Releasing the button copies the selection right away. The selection is not limited to a single widget, so a task or a piece of the preview can be copied as well. Because the selection is taken from the rendered screen, it contains what is actually visible, including borders of the widgets when the selection crosses them.