KimaiClock is a macOS menu bar application that integrates with Kimai to help you track your time directly from your desktop.
Warning
This Version only works with Kimai 2 ( not the legacy Kimai 1 )
- ⏱️ Start, pause & stop timesheets from the menu bar
- 📝 Stop with a description — add a note right from the menu bar without opening Kimai
- 📊 View and resume recent tasks
- 🔔 App launch reminders (VS Code, PhpStorm, Xcode, …)
- 📡 Automatically sync timesheets with Kimai server
- 📥 Controllable via URL schemes (custom hotkeys via macOS Shortcuts, Alfred, Raycast, …)
- 📓 English & German localization
- 🔒 Secure, Apple-notarized build
- ⚡ Lightweight — no third-party dependencies
- 🌑 Dark mode support
- 📨 Actively maintained
For a detailed list of changes, bug fixes, and new features in each release, see CHANGELOG.md.
- Left click → Open/close the popup
- Left long press → Open your Kimai server page in the default browser
- Right click → Toggle play/pause for the active task
Right-clicking the stop button inside the popup opens a context menu with two additional actions:
| Action | Description |
|---|---|
| Stop with description | Opens a prompt to enter a note, then stops and saves the timesheet with that description |
| Discard & delete | Stops the timer and deletes the timesheet entirely — useful when started by accident |
KimaiClock detects when your Mac has been idle for a configurable period while a timer is running. When you return, an alert lets you decide what to do:
- Continue — resume the timer as if nothing happened
- Stop — stop and save the timesheet up to the point you went idle
The idle threshold can be configured in Settings. A "Don't show again" checkbox is available if you prefer to manage this manually.
- Go to the Releases page.
- Download the latest
.dmgfile. - Open it and drag KimaiClock.app to your
Applicationsfolder. - Connect your Kimai Server inside the Settings
- Start tracking time right away 🚀
Tip
KimaiClock can also be installed via our own Homebrew tap right now:
# add company tap
brew tap foraum-gmbh/foraum https://github.com/Foraum-GmbH/homebrew-foraum
# install cask from company tap
brew install --cask foraum-gmbh/foraum/kimai-clockTo uninstall KimaiClock and remove the company tap:
# uninstall the app
brew uninstall --cask foraum-gmbh/foraum/kimai-clock
# remove the company tap
brew untap foraum-gmbh/foraumOnce KimaiClock becomes more popular, we plan to submit it to the official Homebrew Cask repository.
Minimum requirements for official Homebrew Cask inclusion:
- At least 30 forks
- At least 30 watchers
- At least 75 stars on GitHub
KimaiClock supports URL schemes for automation and custom hotkey integration:
| Action | URL | Description |
|---|---|---|
| Pause | kimai-clock://pause |
Pause the currently running timer |
| Stop | kimai-clock://stop |
Stop and clear the active timer |
| Start Last | kimai-clock://startLast |
Start the most recent activity |
Terminal:
open "kimai-clock://pause"macOS Shortcuts:
- Create a new Shortcut
- Add the "Open URLs" action
- Enter the url ( e.g.
kimai-clock://startLast) - Click the ⓘ icon in the top-right
- Select "Add Keyboard Shortcut" (e.g.
⌘⇧L)
The URL schemes also work with third-party automation tools like Alfred, Raycast, or BetterTouchTool.
Warning
Widget support is currently work in progress and may have limited functionality.
A desktop widget is in development that will show the current timer state and elapsed time directly on your desktop or in the menu bar notification area. Available as a lock screen and home screen widget on supported macOS versions.
Contributions, issues and feature requests are welcome!
Feel free to check the issues page.
Distributed under the MIT License.
See LICENSE for more information.