You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Go to file
Kevin Papst 3a5d7a62de
Release 2.0.11 (#3932)
1 day ago
.github fix bug report template 2 months ago
assets Release 2.0.11 (#3932) 1 day ago
bin Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
config Release 2.0.5 (#3888) 3 weeks ago
migrations Release 2.0.9 (#3922) 1 week ago
public Release 2.0.11 (#3932) 1 day ago
src Release 2.0.11 (#3932) 1 day ago
templates Release 2.0.11 (#3932) 1 day ago
tests Release 2.0.11 (#3932) 1 day ago
translations Translated using Weblate (#3937) 4 days ago
var Drop SQLite support (#2405) 2 years ago
.codecov.yml release 2.0 beta (#3722) 2 months ago
.editorconfig Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
.env.dist Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
.eslintrc.js Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
.gitignore Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
.php-cs-fixer.dist.php Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
CHANGELOG.md changed repository url (#3708) 3 months ago
CONTRIBUTING.md Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
LICENSE Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
README.md simplify docs and cleanup links 1 month ago
SECURITY.md Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
UPGRADING.md Cleanup after 2.0 (#3868) 4 weeks ago
babel.config.js Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
composer.json Release 2.0.11 (#3932) 1 day ago
composer.lock Release 2.0.11 (#3932) 1 day ago
package.json Release 2.0.8 (#3914) 1 week ago
phpstan.neon Release 2.0.11 (#3932) 1 day ago
phpunit.xml.dist Release 2.0.2 (#3856) 4 weeks ago
symfony.lock Release 2.0.5 (#3888) 3 weeks ago
webpack.config.js Next major version 2 with PHP 8.1, Symfony 6, Tabler UI, 2FA ... (#2902) 3 months ago
yarn.lock Release 2.0.8 (#3914) 1 week ago

README.md

Kimai logo

CI Status Code Coverage Latest stable version License Mastodon

Kimai - time-tracker

Kimai is a professional grade time-tracking application, free and open-source. It handles use-cases of freelancers as well as companies with dozens or hundreds of users. Kimai was build to track your project times and ships with many advanced features, including but not limited to:

JSON API, invoicing, data exports, multi-timer and punch-in punch-out mode, tagging, multi-user - multi-timezones - multi-language (over 30 translations existing!), authentication via SAML/LDAP/Database, two-factor authentication (2FA) with TOTP, customizable role and team permissions, responsive design, user/customer/project specific rates, advanced search & filtering, money and time budgets, advanced reporting, support for plugins and so much more.

Versions

There are two versions of Kimai existing:

  • Version 1 — compatible with PHP 7.4, which is in maintenance mode since 2023
  • Version 2 — stable and "almost released" (waiting for some major plugins, which are not yet migrated)

Requirements

  • PHP 8.1 minimum
  • MariaDB or MySQL
  • A webserver and subdomain (subdirectory is not supported)
  • PHP extensions: gd, intl, json, mbstring, pdo, tokenizer, xml, xsl, zip

Installation

There are also documentations for:

And if you don't want to host Kimai, you can use the Cloud version of it.

Updating Kimai

Plugins

Roadmap and releases

You can see a rough development roadmap in the Milestones sections. It is open for changes and input from the community, your ideas and questions are welcome.

Release versions will be created on a regular basis, every couple of weeks latest. Every code change, whether it's a new feature or a bugfix, will be done on the main branch.

For the time being and until 2.0 is widely adopted, the 1.x branch will receive bug fixes.

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:

  • Spread the word: More user means more people testing and contributing to Kimai, which in turn means better stability and more and better features. Please vote for Kimai on any software platform, you can toot or tweet about it, share it on LinkedIn, Reddit or any of your favorite social media platforms. Every bit helps!
  • 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!

Credits

Kimai is based on modern technologies and frameworks such as PHP, Symfony and Doctrine, Bootstrap and Tabler, and countless others.