Skip to content

Guide · Open source

How to use Super Productivity: setup, planning and focus

Updated · written with AI from the project's own documentation and checked against our catalogue data

Super Productivity is a to-do list, time tracker and daily planner for personal work. It is private, offline-first and open source, and it can sync across devices. This guide shows you how to install it, organize tasks, plan your day, run focus sessions and keep your data under your control.

Super Productivitysuper-productivity/super-productivity · ★ 23.4k · MIT

Quick start

  1. 1Get the app. Download Super Productivity from the download page or an app store, or open the web app if you do not want to install anything.
  2. 2Create your first project and tasks. Add tasks, group them into projects and tag them. Use sub-tasks for larger items.
  3. 3Plan your day. Open the planner and place tasks on the schedule next to your calendar events.
  4. 4Start a focus session. Use Pomodoro, Flowtime or a countdown in focus mode to work on one task at a time.
  5. 5Turn on sync. Connect SuperSync, Dropbox or WebDAV so your data is backed up and available on other devices.
  6. 6Connect an issue tracker if needed. If you use Jira, GitHub, GitLab or OpenProject, connect it to import assigned tasks and create work logs.

Install Super Productivity or open the web app

The simplest route is to download the desktop or mobile app. The README links to a download page and to app stores, including Flathub, Snap Store, Microsoft Store, Google Play, F-Droid, Obtainium and the App Store. For all current downloads and platform-specific notes, the project wiki page '2.01 Downloads and Install' is the place to check.

If you do not want to install anything, there is an Open Web App at app.super-productivity.com. The README notes that the web version has some limitations compared with desktop, so check the Web App vs Desktop comparison in the wiki before relying on it.

Organize tasks with projects, tags and sub-tasks

Start by capturing work as tasks. You can plan and categorize them with sub-tasks, projects and tags, and color code them as needed. The README also points to short syntax and keyboard shortcuts in the wiki, which can speed up daily entry.

Tasks and projects can carry context. You can add notes, attach files, and create project-level bookmarks for links, files and even commands.

  • Use projects to group work by area.
  • Use tags to cut across projects.
  • Use sub-tasks to break larger items into steps.
  • Check the wiki pages for Keyboard Shortcuts and Short Syntax.

Plan your day on the schedule

The planner shows your day laid out on a schedule timeline, next to your calendar events. This is where you decide what you will work on and when. The README also lists basic CalDAV integration for calendar data.

Boards give you another way to sort tasks. The built-in Kanban and Eisenhower Matrix boards are available, and you can build your own.

  • Open the planner to see the day on a timeline.
  • Check calendar events alongside your tasks.
  • Use Kanban or the Eisenhower Matrix to sort by status or urgency.

Focus with Pomodoro, Flowtime or timeboxing

Focus mode offers Pomodoro, Flowtime and countdown sessions. Timeboxing lets you give a task a fixed block of time, and time tracking records what you actually spend.

A break reminder tells you when to step away. The anti-procrastination feature is meant to help you gain perspective when you need it.

  • Pomodoro: timed focus sessions with breaks.
  • Flowtime: a session style that does not use a fixed countdown.
  • Countdown: a fixed-length focus block.
  • Break reminder: prompts you to step away.

Track time and review your work

Super Productivity lets you create time sheets and work summaries and export them to your company's time tracking system. It can also collect personal metrics so you can see which work routines need adjustment.

Sync your data and connect issue trackers

Back up and synchronize data across devices with SuperSync, Dropbox or WebDAV. SuperSync is the project's own sync service, and the README says it is end-to-end encrypted with a password only you hold. You can also host it yourself using the super-sync-server package.

If you work with issues, the app integrates with Jira, GitHub, GitLab, OpenProject and several other trackers. It can auto import tasks assigned to you, plan details locally, create work logs automatically and notify you when something changes.

Developers who want to work from source can clone the repository with: git clone https://github.com/super-productivity/super-productivity.git

  • Sync options: SuperSync, Dropbox, WebDAV.
  • Issue trackers: Jira, Trello, GitHub, GitLab, Gitea, OpenProject, Linear, ClickUp, Redmine, Nextcloud Deck, Azure DevOps.
  • Extend with plugins and custom themes, both documented in the wiki.
git clone https://github.com/super-productivity/super-productivity.git

What people use it for

  • Keeping a personal to-do list with built-in time tracking.
  • Running Pomodoro or timeboxed focus sessions during deep work.
  • Tracking time against Jira, GitHub, GitLab or OpenProject issues.
  • Exporting time sheets and work summaries for a company time tracking system.
  • Keeping personal data local, with no account required.

Frequently asked questions

Is Super Productivity free?

The README says Super Productivity is free and open source and always will be. It is released under the MIT licence.

Does Super Productivity require an account?

No. The README says no account or registration is required, and that the app does not collect any data. You decide where your data is stored.

What platforms does Super Productivity run on?

The README lists Linux, macOS, Windows, Android, iOS and the browser. Desktop is described as the main focus, and the web version has some limitations compared with desktop.

How do I sync Super Productivity across devices?

You can back up and synchronize data with SuperSync, Dropbox or WebDAV. SuperSync is end-to-end encrypted with a password only you hold, and you can host it yourself.

Can Super Productivity connect to Jira or GitHub?

Yes. The README lists integrations with Jira, GitHub, GitLab, OpenProject and several other trackers, including auto import of tasks assigned to you and automatic work logs.

What are alternatives to Super Productivity?

The project's comparable projects listed in the source are Todoist, TickTick, Tasks.org and Planner. Those are task managers, while Super Productivity focuses on combining tasks with timeboxing and time tracking.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Super Productivity suits people who want a private, personal task list with Pomodoro-style focus sessions and built-in time tracking, especially developers who track work against Jira, GitHub, GitLab or OpenProject. It is not a shared, multi-user project tool, and if you need a web-first or mobile-only experience, check the wiki's comparison and consider a different app.

Install options & downloads