straydragon / super-productivity Goto Github PK

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

• 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 and GitLab. 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!

I wrote a little article on how I use the app. There is also a youtube video available.

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.

Install from the releases page.

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

# stable
sudo snap install superproductivity

# edge channel releases
 sudo snap install --channel=edge superproductivity

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

Install via homebrew cask:

brew cask install superproductivity

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

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.

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).

To run the development server you need to have node installed at least in the version 10. 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 install
npm install -g @angular/cli

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 is done via electron-builder. To start packaging run yarn 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.

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

If using the integrated WebDAV Syncing is not working out for you, you can also try to sync all app files. When starting the app via the command line the path to where emergency backups are saved is printed out to the command line. Just take away the /backup sub folder away and use the remaining path to sync via the cloud.

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

For the desktop version automatic backups are stored per default. You can see the backup folder location printed out when you start the app from the command line. Once you located a backup you can restore it on the settings page underSync & Export/Import/Export/Import from file.