nkh Productivity is my fork of Super Productivity, which is an advanced todo list app with integrated Timeboxing and time tracking capabilities. It also comes with integrations for Jira, Gitlab, GitHub and Open Project.
Go to file
Johannes Millan c1c3261ab4 fix(note): model breaking 2021-11-06 18:53:04 +01:00
.github docs: update first time contributor messages 2021-11-03 17:39:12 +01:00
.vscode Allow For Issues from multiple projects 2021-10-10 16:52:47 +02:00
build build: add missing store logo for appx 2021-11-04 20:05:49 +01:00
docs docs: add additional info on how to update mac os certificates 2021-08-16 14:45:55 +02:00
e2e test: fix nav not open issue for e2e tests 2021-11-06 18:28:05 +01:00
electron feat: improve finish day for electron variant 2021-11-03 17:03:44 +01:00
screens Size optimize all images 2021-05-13 22:28:53 +02:00
src fix(note): model breaking 2021-11-06 18:53:04 +01:00
tools build: change way to extract version 2 2021-09-23 18:19:48 +02:00
.dockerignore chore: provide basic docker image #177 2019-06-08 23:19:46 +02:00
.editorconfig initial commit 2018-05-12 18:34:42 +02:00
.eslintrc.json build: improve eslint config 2021-09-26 16:33:30 +02:00
.gitignore build: update to angular 13 2021-11-06 14:33:55 +01:00
.gitpod.yml Create .gitpod.yml 2021-07-11 13:50:49 +02:00
.prettierignore build: add prettier 2021-05-06 22:37:06 +02:00
.prettierrc.json build: add prettier 2021-05-06 22:37:06 +02:00
CHANGELOG.md 7.7.0 2021-11-04 16:30:52 +01:00
CONTRIBUTING.md Update CONTRIBUTING.md 2021-03-18 19:36:58 +01:00
Dockerfile build: update docker file to work with npm 2021-08-27 21:12:44 +02:00
LICENSE fix: typo in license 2019-01-29 18:21:51 +00:00
README.md Update README.md 2021-10-27 21:15:52 +02:00
angular.json build: remove angular custom-webpack in favor of standard angular builder 2021-10-15 12:17:20 +02:00
electron-builder.yaml build: try building for mac arm #1516 2021-09-17 10:05:30 +02:00
ngsw-config.json fix(dbx): disable service worker caching issue provider stuff completely for now #645 2020-11-06 00:10:54 +01:00
package-lock.json build: npm audit fix 2021-11-06 18:10:38 +01:00
package.json build: npm audit fix 2021-11-06 18:10:38 +01:00
tsconfig.base.json feat: migrate tslint noUnusedLocals to eslint rule as it is annoying 2021-06-11 10:51:20 +02:00
tsconfig.json build: update to angular 10.1 2020-09-16 22:06:24 +02:00

README.md

Banner

MIT license GitHub All Releases On product hunt tweet

Get it from the Snap Store English badge App Store Badge Play Store Badge

Organize your daily tasks in one place while making time tracking a lot less annoying. Super Productivity is a ToDo List / Time Tracker / Personal Jira Task Manager for Linux, MacOS and Windows aimed at reducing the time you spend with repetitive tasks and to provide you with a place to collect all the information you need to do your job.

🌐 Open Web App or 💻 Download

✔️ Features

  • Plan, track & summarize. Create time sheets and work summaries in a breeze to easily export them to your company's time tracking system.
  • Integrate with Jira, GitHub, GitLab and OpenProject. Auto import tasks assigned to you, plan the details locally, automatically create worklogs and get notified right away, when something changes.
  • Organize your project's data. Create notes, attach files or create bookmarks for links, files and even commands and have it all out of the way, once you're ready for the weekend.
  • Helps you to establish healthy habits. A break timer reminds to you, when it's time to step away. You also can collect personal metrics for yourself to see, which of your work routines need adjustments.
  • Stuck and procrastinating? No problem! Super Productivity's anti procrastination feature helps you to reconsider your options and a pomodoro timer is also always at hand.
  • Super Productivity does NOT collect any data and there are no user accounts or registration. It's free and open source and always will be.

And much more!

Work View with global links

How to use it

I wrote a little article on how I use the app - and another one on how I implement the 'eat the frog' prioritizing scheme in the app . There is also a youtube video available.

🌐 Web Version

Check out the web version eventhough it is a bit limited: Time tracking only works if the app is open and for idle time tracking to work, the chrome extension has to be installed.

If you want the Jira integration and idle time tracking to work, you have to also download and install the Super Productivity Chrome Extension.

💻 Downloads & Install

All Platforms

Install from the releases page.

Windows

Due to certification issues it's recommended to download the app from the Microsoft Store:

English badge

Linux

# stable
sudo snap install superproductivity

# edge channel releases
 sudo snap install --channel=edge superproductivity
 
 # it is also recommended to disable updates to the app while it is running:
 sudo snap set core experimental.refresh-app-awareness=true
Get it from the Snap Store

Arch

git clone https://aur.archlinux.org/superproductivity-bin.git
cd superproductivity-bin
makepkg -si

MacOS

Install via homebrew cask:

brew install --cask superproductivity
App Store Badge

Android

There is a very early(!) Android version available. The sources can be found here.

App Store Badge

♥️ Contributing

Please check out the CONTRIBUTING.md

There are several ways to help.

  1. Spread the word: More users means more people testing and contributing to the app which in turn means better stability and possibly more and better features. You can vote for Super Productivity on Slant, Product Hunt, Softpedia or on AlternativeTo, you can tweet about it, share it on LinkedIn, reddit or any of your favorite social media platforms. Every little bit helps!

  2. Make a feature or improvement request: Something can be be done better? Something essential missing? Let us know!

  3. Report bugs

  4. Contribute: You don't have to be programmer to help. Some of the icons really need improvement and many of the translations could use some love.

  5. Sponsor the project

Pull Requests

Pull requests are of course very welcome! Please make sure that you're following the angular commit guidelines and to also include the issue number in your commit message, if you're fixing a particular issue (e.g.: feat: add nice feature with the number #31).

Running the development server

To run the development server you need to have node installed at least in the version 14. Go to https://nodejs.org for installation instructions.

Clone repo

git clone https://github.com/johannesjo/super-productivity.git

Install dependencies

cd super-productivity
npm i -g @angular/cli
npm i

Run the dev server

ng serve

Afterwards you can open http://localhost:4200 in your browser. For most adjustments this should be enough and also enables you to use the redux dev tools.

If you want to run the app standalone do the following:

ng serve

# in a new console tab
npm start

Packaging the app

Packaging the app is done via electron-builder. To start packaging run npm run dist. If you want to add new platforms and experiment with the build options the easiest way to do so is manipulating the build property in the package.json, but you can also use the command line interface of electron builder.

Run as Docker Container

docker run -d -p 80:80 johannesjo/super-productivity:latest

Custom themes (desktop only)

In addition to color coding your projects and tags and to the dark and light theme you can also load completely custom css to restyle everything. To load a custom theme you simply need put them into a new file named styles.css directly in the user data folder.

There is a great set of themes available for download in this repository as well as some info on how to role out your own custom themes.

Custom WebDAV Syncing

If using the integrated WebDAV Syncing is not working out for you, you can also try to sync all app files, which are located in the user data folder.

Automatic Backups

For the desktop version automatic backups are stored per default in the backup sub folder of the user data folder. Once you located a backup you can restore it on the settings page under Sync & Export/Import/Export/Import from file.

User Data Folder

Where user data is stored differs from os to os. The most common locations are: Mac OS: ~/Library/Application Support/superProductivity/ Windows: C:\Users\<YOUR_USER_NAME>\AppData\Roaming\superProductivity/ or %APPDATA%\superProductivity Linux: ~/.config/superProductivity/

The path should be shown when you go to the "Automatic Backups` section on the configuration page (minus the "backup" sub folder). You can also see it printed out when you start the app from the command line.

For web browsers data is simply stored for the current user inside the browser storage.

Using a custom folder to save user data

You can specify a custom folder for saving your data by starting the application with the --user-data-dir parameter like so:

superproductivity --user-data-dir=/path/to/my/data