Keyboard shortcuts
Every keyboard shortcut in the PerspecTask web app, grouped by where it works, with the Mac and Windows keys for each.
PerspecTask has three kinds of shortcuts. App-wide combos with ⌘ (Mac) or Ctrl (Windows) work everywhere, even while you type. Single-key task shortcuts act on the task under your mouse pointer. Some pages, like Gantt, Treemap and Bullets, add their own keys on top.
Single keys never fire while the cursor is in a text field, so typing a title never triggers them. On Windows and Linux, Ctrl takes the place of ⌘.
Everywhere
These work on every page.
| Action | Mac | Windows |
|---|---|---|
| Open search | ⌘K | Ctrl+K |
| Show or hide the sidebar | ⌘B | Ctrl+B |
| Change the encryption default for new tasks (Auto, Encrypted, Plaintext) | ⌘E | Ctrl+E |
| Lock or unlock encrypted tasks | ⌘⇧E | Ctrl+Shift+E |
⌘E cycles the "New tasks" setting and shows a toast with the new value. Auto encrypts new tasks while your password is unlocked and leaves them plaintext otherwise.
⌘⇧E asks for your password when encrypted tasks are locked. When they are unlocked, it locks them again straight away by dropping the key from memory.
The task under the pointer
Rest the mouse pointer on a task row, then press a key. The same keys work on task rows across the app, on Gantt bars and on bullets.
| Action | Mac | Windows |
|---|---|---|
| Change the deadline (date picker) | D | D |
| Open the task menu | M | M |
| Add a subtask | S | S |
| Set priority 1, 2 or 3 | 1 2 3 | 1 2 3 |
| Remove the priority | 0 | 0 |
| Set the status: Inbox, Ready, In Progress, Waiting, Delegated | ⇧1 to ⇧5 | Shift+1 to Shift+5 |
| Cancel the task, or reactivate it | C | C |
| Pin to the sidebar, or unpin | P | P |
| Add to a new parent (the next task you click becomes the parent) | A | A |
| Open "Blocked by" | B | B |
| Copy the task's short id | I | I |
| View the task's history | H | H |
| Open the task in the kanban view | K | K |
| Encrypt or decrypt the task | E | E |
| Encrypt or decrypt the task and all its subtasks | ⇧E | Shift+E |
| Delete the task (asks first) | ⌫ | Backspace |
Writing and editing
| Where | Action | Mac | Windows |
|---|---|---|---|
| Add task field | Create the task | ↵ | Enter |
| Add task field | Clear the field and leave it | Esc | Esc |
| Editing a task title | Save | ↵ | Enter |
| Editing a task title | Undo your changes and stop editing | Esc | Esc |
| Search | Clear the search text, or close search when it is empty | Esc | Esc |
| "Blocked by" search | Move through the results | ↑ ↓ | ↑ ↓ |
| "Blocked by" search | Add the highlighted task | ↵ | Enter |
| "Blocked by" search | Close it | Esc | Esc |
| Canvas: add a task | Move through the results | ↑ ↓ | ↑ ↓ |
| Canvas: add a task | Add the highlighted task | ↵ | Enter |
| Canvas: add a task | Close it | Esc | Esc |
| Pull request link field | Link the pull request | ↵ | Enter |
| Pull request link field | Cancel | Esc | Esc |
| Editing a timer session's time | Cancel the edit | Esc | Esc |
Gantt
Open Gantt from the sidebar. These keys work while the pointer is not on a task and no dialog is open. The calendar jumps use ⌘ or Ctrl, so they also work with the pointer on a bar.
| Action | Mac | Windows |
|---|---|---|
| Centre on today, keeping the time shown | T | T |
| Back to the default view (1 year around today) | R | R |
| Zoom out until every bar fits | F | F |
| Add a period or a milestone | N | N |
| Go back or forward by the time shown | ← → | ← → |
| Show less time (zoom in) | + or = | + or = |
| Show more time (zoom out) | - | - |
| Jump to This day, This week, This month, This quarter, This year, Last 5 years, This decade, This century | ⌘1 to ⌘8 | Ctrl+1 to Ctrl+8 |
| Swap what the scroll wheel does (zoom or scroll the page) | ⇧S | Shift+S |
| Show or hide lanes with nothing in view | ⇧L | Shift+L |
| Show or hide the "blocked by" arrows | ⇧A | Shift+A |
Hold ⇧ (Shift) over an empty part of the board to get a + for adding a timeline or a task there.
Treemap
Open Treemap from the sidebar. These keys work while the pointer is not on a task and no dialog is open.
| Action | Mac | Windows |
|---|---|---|
| Show Labels | L | L |
| Show Tasks Once (a task with several parents is drawn once) | O | O |
| Hide Done | D | D |
| Hide Done Maps | M | M |
| Show Priority | R | R |
| Play or pause the evolution | Space | Space |
| One step back or forward in the evolution | ← → | ← → |
| Change the step: day, week, month, quarter, year | P | P |
| Existing only (leave out tasks that did not exist yet) | E | E |
| Show future | F | F |
Bullets
The Bullets page has the most shortcuts. Press ? on the page, or open the ⋯ menu, to see the full list in the app. The same key can mean different things depending on where the cursor is, so the tables below follow the same groups.
Writing a bullet
When the cursor is in a bullet's title.
| Action | Mac | Windows |
|---|---|---|
| Save | ↵ | Enter |
| Write this bullet's note | ⇧↵ | Shift+Enter |
| Complete or un-complete it | ⌘↵ | Ctrl+Enter |
| Indent (become a subtask of the bullet above) | Tab | Tab |
| Outdent (move up one level) | ⇧Tab | Shift+Tab |
| Save and remove focus | Esc | Esc |
Moving around
When the cursor is in a bullet, or parked there by Esc.
| Action | Mac | Windows |
|---|---|---|
Previous or next bullet (↓ past the last one goes to the empty row) | ↑ ↓ | ↑ ↓ |
| Move the bullet among its siblings | ⌘⇧↑ ⌘⇧↓ | Ctrl+Shift+↑ Ctrl+Shift+↓ |
Writing a note
When the cursor is in a bullet's note.
| Action | Mac | Windows |
|---|---|---|
| New line | ↵ | Enter |
| Save and go back to the title | ⇧↵ or Esc | Shift+Enter or Esc |
The whole outline
When the cursor is not in a bullet. Inside a bullet, ⌘⇧↑ and ⌘⇧↓ move the bullet instead.
| Action | Mac | Windows |
|---|---|---|
| Collapse all | ⌘⇧↓ | Ctrl+Shift+↓ |
| Expand all | ⌘⇧↑ | Ctrl+Shift+↑ |
| Expand by status (fold the finished branches) | ⌘⇧→ | Ctrl+Shift+→ |
| Collapse the selected bullet and everything under it | ⌘↑ | Ctrl+↑ |
| Expand the selected bullet by status, then fully if pressed again | ⌘↓ | Ctrl+↓ |
| Show or hide the parents and deadline under each bullet | V | V |
| Open the shortcut list | ? | ? |
Ordering the outline
Two keys, one after the other, with the cursor not in a bullet. They work with the pointer anywhere on the page.
| Action | Mac | Windows |
|---|---|---|
| Order once by status, then leave it manual | ⇧S then S | Shift+S then S |
| Order once by priority | ⇧S then P | Shift+S then P |
| Order once by name | ⇧S then N | Shift+S then N |
| Order once by created date | ⇧S then C | Shift+S then C |
| Order once by direct subtask count | ⇧S then T | Shift+S then T |
| Order once by total subtasks, every level | ⇧S then A | Shift+S then A |
| Keep the outline in manual order | ⇧O then M | Shift+O then M |
| Keep the outline ordered by status, priority, name, created, subtask count or total subtasks | ⇧O then S, P, N, C, T or A | Shift+O then S, P, N, C, T or A |
Repeat the same two keys to reverse the order. For "order once", the repeat has to come within 10 seconds. Manual order does not reverse.
Several bullets at once
When one or more bullets are selected.
| Action | Mac | Windows |
|---|---|---|
| Add a bullet to the selection, or take it out | ⌘+click | Ctrl+click |
| Grow the selection | ⇧↑ ⇧↓ | Shift+↑ Shift+↓ |
| Back to one bullet | ↑ ↓ | ↑ ↓ |
| Drop the selection | Esc | Esc |
| Complete them all, or un-complete | ⇧↵ or ⌘↵ | Shift+Enter or Ctrl+Enter |
| Cancel them all, or reactivate | C | C |
| Set their priority | 0 1 2 3 | 0 1 2 3 |
| Set their status | ⇧1 to ⇧5 | Shift+1 to Shift+5 |
| Give them one deadline | D | D |
Encrypt or decrypt them (⇧ includes their subtasks) | E or ⇧E | E or Shift+E |
| Add them all to one new parent | A | A |
| Copy their short ids | I | I |
| Delete them (asks first) | ⌫ | Backspace |
The bullet under the pointer
The task shortcuts above work on bullets too, with one difference: on the Bullets page ⇧S starts an ordering chord instead of adding a subtask. Plain S still adds one.
With the mouse
| Action | Mac | Windows |
|---|---|---|
| Zoom into a bullet | Click its dot | Click its dot |
| Open a bullet in a new pane beside this one | ⇧+click its dot | Shift+click its dot |
| Cancel dragging a pane | Esc | Esc |