Skip to content

progeek-de/kimai-client

Repository files navigation

Kimai Client (work-in-progress 👷🔧️👷‍♀️⛏)

Kimai-Client is a multiplatform (Windows, OSX, Linux) desktop client written in Kotlin for Kimai Time Tracker.

Kimai Client offers seamless integration with the Kimai Time Tracker Server, allowing users to manage multiple workspaces simultaneously. This integration facilitates efficient time tracking across multiple projects and clients. All time tracking data is securely stored on the designated Kimai server, which supports both on-premises and SaaS cloud options, ensuring data privacy and easy accessibility.

Connection

To get started with Kimai Client, make sure you have a working Kimai setup, which can be your own server or a Kimai Cloud account. Generate an API password and login with your credentials.

Dark mode

For design enthusiasts, Kimai Client's Dark Mode is a stylish option to consider. You can easily switch between the traditional bright interface and the elegant dark theme. This feature not only enhances visual comfort, but also adds a personal touch to your time tracking experience.

Compose Multiplatform

As mentioned above, this app's UI is completely written in Compose Multiplatform.

Compose for Desktop client

This client is available in compose-desktop module and can be run using ./gradlew :kimai-desktop:run. Note that you need to use appropriate version of JVM when running (works for example with Java 17)

Contributing

You want to contribute to this repository? This is so great! The best way to start is to open a new issue for bugs or feature requests or a discussion for questions, support and such.

In case you want to contribute, but you wouldn't know how, here are some suggestions:

  • Answer questions: You know the answer to another user's problem? Share your knowledge.
  • Something can be done better? An essential feature is missing? Create a feature request.
  • Report bugs makes Kimai better for everyone.
  • You don't have to be programmer, the documentation and translation could always use some attention.
  • Sponsor the project: free software costs money to create!

There is one simple rule in our "Code of conduct": Don't be an ass!