KHarvest

A native KDE application written with Kirigami that integrates with Harvest to automate time tracking.

First Run

You will need to log in the first time you use the application.

On the first run, the app will open the Harvest login page in a browser for you to log in and provide access to the app. Once you have logged in and see the message "Authentication successful, you may now close this tab" (depending on your system language) the app will load your data and open up ready to use

App Screenshots

Main Window

Adding a Task

Favourites

System Tray Icon

Coming Soon

Installation

You can build the app by yourself, or simply grab the prebuilt binary in the releases section.

Additionally, in Arch-based distros you can find a package in the AUR repository.

Binary File

If you are happy with just grabbing the binary file, you can do so from the latest release in the releases section, download the binary pack and use it on your system as you prefer.

DEB and RPM Files

You can install both the deb and rpm packages attached on every release.

Arch Linux (AUR-enabled distros)

You can use your favourite installation method (yay, software centre, etc.) to install harvest-timer-qt

Dependencies

The app has very few dependencies, but you need to bear these in mind especially if you are going to build it from sources:

Build Dependencies

• Modern C++ compiler (g++, clang)
• CMake
• Qt5 Tools, the package name of which may vary:
  • Ubuntu: qt5-tools-dev
  • Fedora: qt5-qttools
  • Arch: qt5-tools

Runtime Dependencies

Required

• The Qt5 Base package, some namings for this, depending on distros, are
  • Ubuntu: qtbase5-dev
  • Fedora: qt5-qtbase
  • Arch: qt5-base
• Similarly, you will need the Qt5 SVG package to display icons:
  • Ubuntu: libqt5svg5
  • Fedora: qt5-qtsvg
  • Arch: qt5-svg
• A base installation of KDE Frameworks 5 is required

Optional

• If you are running Harvest in a wayland system, installing the Qt5 Wayland package to allow Qt to interact directly with the compositor:
  • Ubuntu: qtwayland5
  • Fedora: qt5-qtwayland
  • Arch: qt5-wayland

Troubleshoot

Missing Data

If you have logged in and the list of projects/tasks is empty, login to the web portal and verify that you have projects and tasks assigned to you.

If that fails, you can try logging out and logging in again. You can do either of the following to logout:

1. Log out from the application menu
2. Re-running the login process by clearing the app's data from your keychain