Getting started with Super Productivity
Tags: productivity, workflow, tips
Published: 2022-01-06 15:51:42

---
title: Getting started with Super Productivity
published: true
description: How to use Super Productivity
tags: productivity, workflow, tips 
canonical_url: https://super-productivity.com/blog/getting-started-with-super-productivity
path: /blog/getting-started-with-super-productivity
author: Johannes Millan
---


[Super Productivity](https://super-productivity.com/) is an advanced open source todo list app with integrated [Timeboxing](https://de.wikipedia.org/wiki/Timeboxing) and time tracking capabilities. While the app won't magically solve all your productivity, time management and procrastination issues, the combination of planning ahead and quickly re-planning whenever necessary, breaking tasks down into smaller bits and doing a bit of timeboxing can be a surprisingly powerful combination.

The following article will introduce the basic features of the app. Since quickest way to do things in Super Productvity, is to use keyboard shortcuts, I will be focussing on using the most important ones in this tutorial.

## Plan your tasks and break them down

### Adding new tasks

First thing you want to do when starting the app is to create a task. When there are no tasks the app should greet you with an input box to do so. If you already created some you can use the "+" button in the top right or the keyboard shortcut `Shift+A` to do so. You can close the add task overlay by pressing escape.

![Add task bar](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/336ees415q3rjfc9oltu.png)

Below the input where you enter the task title you can see a little info text which introduces the **short syntax**. Using the short syntax you can quickly add and edit the time estimated and spent for a task (and also the project and tags assigned to it).

#### Adding estimates at task creation
Giving time estimates to tasks (aka Timeboxing) is recommended as it can help to increase focus, avoid procrastination and reduce the time spent on a task. To create a new timeboxed task:

1. Press `Shift+A` (requires the app window to be focused)
2. Enter "`Getting to now Super Productivity 30m`"
3. Press the `Enter` key to create the task
4. Press the `Escape` key to close the overlay

### Tracking time

To start tracking time you can either press the `y` key while a task is focused or click on the little "play" button that appears once you hover it. To stop press `y` again or press the "pause" button at the top right of the screen.

#### Productivity Tip: Don't beat yourself up about not meeting the times you estimated and re-plan instead!

Timeboxing is meant to be a tool to help you and not intended to provide you with fixed deadlines to be stressed out about. **Plans are always very likely *not* to go *exactly* as you intended** and that is fine! However, an exceeded time estimate might give you a good indication, when it is time to take step back and to consciously adjust your plans and maybe to tackle the problem at hand from another angle.

### Completing tasks

Tasks can be marked as done by pressing `d` or by clicking on the checkmark button that appears when hovering it. For the mobile app you swipe the task to the right.

### Editing tasks

Once a task is focused (indicated by the colored border around them) you can quickly navigate to other tasks in the list by using the arrow keys. Pressing `Enter` will allow you to edit the task title (and also using the short syntax here again). Press `Enter` again to save the changes you made.

### Prioritize tasks

In addition to using custom tags (e.g. "#A #B #C #important") the most efficient way to prioritize your tasks is by simply ordering them. You can do so by dragging them around using the drag handle to the left of the task title or by moving them via `Ctrl+Shift+ArrowUp` and `Ctrl+Shift+ArrowDown` to move them up and down.

### Break tasks down by adding subtasks

When you are facing a big and/or complex task, it usually helps a lot if you break it down into smaller, more manageable parts. This will help you avoid stress and procrastination. The quickest way to add a subtask is to press `a` while a task is being focused. Alternatively you can use the task context menu which can be opened up by right-clicking on the task (or long pressing it on macOS).

#### Hint: Use markdown checkboxes if you need another subtask level

To avoid never completed giant mega tasks – which can be frustrating to deal with – subtasks are limited to one level, if you really need another level, you can use markdown, inside the task notes panel to write another checklist. To do so select a task via keyboard and press the `ArrowRight` key, which will open up an additional panel form the right. You can select the items in this panel via the arrow keys (`ArrowUp`/`ArrowDown` to move and `ArrowRight`/`Enter` to select an item). Under "Description" you find a small panel where you can enter some [markdown](https://www.markdownguide.org/getting-started/) text for additional context information. Using the following syntax will provide you with a check-list:

```  
- [ ] Some item
- [x] Checked item
- [x] Another checked item
```

And produce the following result:

![Nested subtasks](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/xvm6kprrq9lbe109ubdl.png)

#### Hint: Avoid mega tasks
It also might be helpful to avoid long ongoing tasks with hundreds of subtasks. It might feel better to create a new task instead and simply assigning a number to them such as "My long task 2" and to then drag the remaining subtasks over to it. This approach might also make it easier to focus on the current problem at hand and to put irrelevant stuff out of your mind.

### Recap: The most important shortcuts

* `Shift+A`: Open add task bar
* `Enter`: Edit currently focussed task title
* `Arrow keys`: Navigate around task list
* `D`: Mark currently focused task as done
* `A`: Add subtask to currently focused task
* `Y`: Toggle tracking time to currently focused task
* `S`: Open schedule dialog for currently focused task
* `Backspace`: Delete currently focused task
* `ArrowRight`: Open additional info panel for currently focused task
* `Ctrl+Shift+ArrowUp`: Move currently focused task up in list
* `Ctrl+Shift+ArrowDown`: Move currently focused task down in list

You can edit these and all other shortcuts on the settings page.

## Moving done tasks to the archive (and finishing your day)

At the bottom of the task list you find a button labeled "Finish Day". Clicking it will bring you to the another page, that gives you an overview over what you did that day. We ignore that for now and scroll to the bottom of the page where there is another button labeled "Save and go home". By clicking it all (non sub-) tasks will be moved to the task archive.

### Productivity Tip: Why reflecting and winding down is a good idea

In most literature about productivity giving yourself a pat on the back, winding down and taking a moment to reflect after a busy day is considered a good practise as it helps you among other things with getting some distance between you and your work, which in turn allows to be more refreshed and productive the next day.

## What else is there?

These are the most important basic Super Productivity offers and that should be enough to get some benefit out of the app. There are other helpful (and all optional) features, too, which I would recommend gradually exploring and to experiment with whatever might work for you.

### Projects, Tags and Color Coding

Each task can have multiple tags assigned, but only a single project. Each project and tag offers its own sortable list, which could be helpful if you only want to work on a particular subject and hae everything else out of the way.

### Import tasks from your companies project management software

Super Productivity allows you to directly import tasks from Jira, GitHub, GitLab and Open Project. This allows you to integrate your personal planning with that of your team.

### Get an overview over time via the Timeline
The timeline view offers a quick overview on how your planning might work out over time. Non-scheduled tasks float around scheduled tasks, and you can also show data from your calendar there.

### Time sheets & worklogs
There are multiple ways that allow you to export the tracked time in different formats, which might be handy in case you need to report your time worked somewhere.

### Productivity Helpers

#### Break reminder

Reminds you to regularly take breaks. Can be (de)activated on the settings page.

#### Pomodoro timer

Integrated pomodoro timer if you need some extra focus. Can be activated on the settings page.

#### Procrastination Helper

Some emergency information about procrastination and some tools to help with it. Can be reached by clicking on the flash button in the top right.

#### Simple counters

Freely configurable stopwatch and single click counters, to be used for whatever you please. E.g. a coffee counter. Can be configured on the settings page.

#### Evaluate your work days

Collect simple metrics to get a better grasp at what works for you and what doesn't. Can be filled on the "Finish Day" page and evaluated on the "Metrics" pages.