Budgie Kimai Timetracker Applet

This is a Budgie panel applet that allows you to connect to and track time using the Kimai Timetracker API.

Installing

Find and download the .deb package in the latest release.

Install using the command:

sudo dpkg -i budgie-kimai-timetracker-applet_<version>_amd64.deb

Replace <version> with the actual version number in the filename.

Usage

1. Add the applet to your Budgie panel in the Budgie Desktop Settings application.

2. In the Kimai webapp, navigate to "My Profile" -> "API Access" -> "Create" to create an API token.

3. Click the tray icon.

4. Go to settings and fill out base URL and API token.

5. Now you can create new timers and stop them. The applet will also update its status if you start and stop timers in the Kimai webapp.

Building

Prerequisites

Ensure you have the required dependencies installed:

sudo apt install budgie-core-dev
sudo apt install libgtk-3-dev libglib2.0-dev
sudo apt install libjson-glib-dev libsoup2.4-dev libsecret-1-dev
sudo apt install meson ninja-build valac

Build Debian Package

First build the .so library:

meson setup build
ninja -C build

Then build a .deb package:

dpkg-buildpackage -us -uc

Contributing

Contributions of all kinds are welcome. These could be suggestions, issues, bug fixes, documentation improvements, or new features.

For more details see the contribution guidelines.

License

This Budgie panel applet was created by Peter Grønbæk Andersen and is licensed under GNU GPL v3.