Menu

Using OpenTodo GuidesVersion 0.1.0

Keyboard shortcuts

Everything in OpenTodo can be done from the keyboard. You don't need to learn it all: q to add, j / k to move, c to complete and ? to look up the rest gets you a long way.

On this page

Shortcuts don't fire while you're typing in a field. Press Esc to leave the field first.

See them in the app#

Press ? at any time for the full list. It's the same list as on this page, generated from the same source, so the two always match.

The Keyboard shortcuts dialog open over the Today view.

The ones to learn first#

Keys Does
q Add a task
j / k Move down and up the list
Enter Open the selected task
c Complete it
1 … 4 Set its priority
g then t Go to Today (i for Inbox, u for Upcoming)
Esc Close the panel

A two-step shortcut like g then t means: press g, let go, then press t.

On a Mac, use ⌘ where this page says Ctrl, and Option for Alt.

All shortcuts#

Everywhere#

Keys What it does
q Quick add a task
Shift+V Dictate into quick add (turn voice capture on in Settings first); Esc or a pause stops, Enter saves
Esc Close panel, clear selection
? Toggle this help

Go to a view#

Keys What it does
g then i / t / u / c / l / f / v / s Go to Inbox / Today / Upcoming / Completed / Labels / Filter / Views / Settings
g then a Go to Assigned to me
g then x Go to the Trash
g then h Go to Activity: what changed in your shared projects (j / k select, Enter opens the task, Tab reaches the filters)
g then Shift+I Go to Settings → Import data
g then d / w Go to the Day / Week calendar
g then ? Open Help: the user guide, offline, with search

Tasks in a list#

Keys What it does
j / k Move selection down / up
Enter Open selected task; accept "complete parent too?"
c Complete / reopen selected task (and its subtasks)
a Add a subtask to the selected task
Shift+A Assign the selected task (type to find a member, Enter assigns)
Tab / Shift+Tab Indent under previous sibling / outdent
Alt+↑ / Alt+↓ Move the selected task, or the focused sidebar project, one place within its list (it stays selected)
Alt+Shift+↑ / Alt+Shift+↓ Move it to the top / bottom of its list
Drag (touch: press and hold) Reorder tasks in project lists, boards and the Inbox, and projects in the sidebar; drop on the middle of a row to nest it; Esc cancels
Today, Upcoming, Assigned, Completed, labels, filters Sorted by date (or their own rule): no drag or Alt moves there
← / → Collapse / expand subtasks of the selected task, or sub-projects of the focused sidebar project
v Toggle the current project between list and board (remembered per project on this device)
Shift+S Share the current project: add members by email, change roles, remove, leave, transfer
1 – 4 Set priority of selected task
L Labels of selected task (type to find, Enter adds or creates)
e Edit the estimate of the selected task (type 20, 45m, 1h30; Enter)
s Schedule the selected task: Day view in placement mode
Shift+S Skip the current occurrence of a recurring task
Shift+O Recurring task: this occurrence only (standalone copy, series moves on)
Delete Delete selected task (and its subtasks)
z Task panel open: fix a timed due to your time zone, or release it to a floating time

Board#

Keys What it does
h / l, ← / → Select the first task of the previous / next column; j / k move within a column
Shift+← / Shift+→ Move the selected task to the previous / next column (it stays selected)
a Add a task to the selected task’s column

Day and Week calendar#

Keys What it does
j / k Select the next / previous task (lane, then blocks)
↑ / ↓ Move the selected task 15 minutes (a lane task gets a time)
← / → Move the selected task one day
Shift+↑ / Shift+↓ Shorten / lengthen the estimate by 15 minutes
u / p Unschedule (keep the date) / placement mode for the selected task
Enter / Esc Place the task at the ghost / cancel without changes
[ / ] / t Previous / next day or week, back to today

Filter, saved views and dashboards#

Keys What it does
Enter / Esc In Filter: jump from the query to the first result / back to the query
s In Filter results: save the query as a view, pinned to the sidebar
/ In a saved view: edit the query; Enter saves it, Esc discards
Tab / Shift+Tab On a dashboard: move between panels; j / k inside a panel, Enter opens, o opens the view
↑ / ↓ In the filter query: recall recent queries on this device

Trash and projects#

Keys What it does
m Move the current project under another project or to the top level
j / k, r, Delete In the Trash: select, restore, delete permanently (Enter confirms, Esc cancels)
Enter After completing the last task of a project: archive the project; any other key dismisses

Comments and notes#

Keys What it does
Shift+C Comment on the open task: focus the composer (markdown; @ completes members, ↑ / ↓ and Enter pick)
Ctrl+Enter / ⌘+Enter In a comment: post the comment, reply or edit; Esc cancels or leaves the field
Tab, Enter In the comment thread: reach Reply, Edit and Delete on a comment; Load older activity at the end
Shift+H In a project: show or hide the project activity; Tab reaches the person and kind filters
Ctrl/⌘+B, I, Shift+X, E, K In the notes: bold, italic, strikethrough, inline code, link
Ctrl/⌘+Alt+1–3 / 0 In the notes: heading 1–3 / normal text
Ctrl/⌘+Shift+8 / 7 / 9 In the notes: bullet, numbered, check list; Ctrl/⌘+Enter ticks a check item; Tab / Shift+Tab indent
- · 1. · # · [ ] · x Typed in the notes: markdown typing becomes formatting; Shift+Enter is a line break, Esc leaves the notes

Settings#

Keys What it does
Enter On an invitation: Settings → Members: copy the invite link created in this session
Delete On an invitation: Settings → Members: revoke a pending invitation
d / r / Delete On a user: Settings → Users: deactivate or reactivate, create a reset link, delete (each confirms)
g then s, Tab Settings → Security: add, rename (Enter saves, Esc cancels) or delete passkeys

Quick add syntax#

Type What it does
<code>tomorrow · next Wed · 3 Feb · at 3pm</code> Due date and time (6 languages)
<code>#project @label p1 +30m</code> Project, label, priority, estimate
<code>"quoted text"</code> Keep text literally
Backspace ×2 End of line: highlight, then dismiss the last chip

Vim keybindings#

If you're used to Vim, turn on Settings → Keyboard → Vim keybindings. It's off by default and applies to that device only. With it on, a small indicator shows the mode (Normal, Insert or Command), and you get:

  • counts like 3j, gg and G for the first and last task,
  • dd to delete, x to complete, o to add a task below and i to edit,
  • J / K to move the selected task,
  • a command line on : with :today, :project <name>, :new <title>, :sync and :help.

All the usual shortcuts keep working. With Vim keybindings on, the ? list includes a Vim section.

Edit this page on GitHub