Branding your Kimai

Kimai offers some basic configuration settings, to adapt the branding to your company.

Ask yourself: which paid software allows such an option?
If you use these options, you should really consider to donate something back to Kimai.

Since 1.5 you can customize these settings directly from the System configurations screen.

What can be customized?

  • You can change the login screen and add your logo
  • You can replace the application name with your company name (approx. 15-20 character)
  • You can replace the mini version “KTT” with an abbreviation for your company name (3 chars max)
  • The browser title can be replaced as well
kimai:
    theme:
        branding:
            logo: "https://www.kimai.org/assets/icon/apple-touch-icon.png"
            company: Acme University
            mini: AC
            title: Awesome!

If you remove the logo, the value of company will be used in the login screen.

If you need to show some more characters in the application name, you can use the CustomCSS plugin to adapt the font size.

Translations

If you can’t live with the default translations (eg. they don’t reflect your industry), then you can add a single translation file, which will be queried always as first translation source. First you configure it like this:

kimai:
    theme:
        branding:
            translation: my-company

The you create a file my-company.en.xliff either in the translations/ directory (should be avoided if possible) or in the translation directory of your company plugin at Resources/translations/.