TimeTracker

日本語 | 简体中文

TimeTracker is a macOS menu bar app for tracking time by project.

Screenshots

• macOS 14 or later
• All data is stored locally

Features

• Start and stop timers from the menu bar, track multiple projects concurrently, or start from an earlier time.
• Automatically stop running timers after a period of inactivity and exclude idle time from your records.
• Add work notes to records and edit them from the list or monthly timeline.
• Review monthly tracked time and export reports as CSV files.
• Manage projects and configure idle detection, launch at login, display language, and other preferences.

Privacy

Your records stay on your Mac and are never sent elsewhere. Idle detection does not capture your input; it only checks the time since the last keyboard or mouse event. Accessibility and Input Monitoring permissions are not required.

Installation

Download TimeTracker-vX.Y.Z.zip from the latest release, extract it, and move TimeTracker.app to /Applications.

The app uses an ad-hoc signature and is not notarized by Apple. The first time you open it, macOS may block it because the developer cannot be verified. After trying to open the app, go to System Settings > Privacy & Security, scroll down to Security, and click Open Anyway. See Apple's instructions for opening an app from an unknown developer.

Build from source

Building from source requires Xcode and XcodeGen. Install XcodeGen with Homebrew:

brew install xcodegen

Clone the repository and build the app in /Applications:

git clone https://github.com/HappyOnigiri/TimeTracker.git
cd TimeTracker
make install

make install replaces an existing /Applications/TimeTracker.app.

Contributing

Please use Issues for bug reports and feature requests, and submit changes as pull requests.

Before opening a pull request, install SwiftLint and verify that make ci succeeds:

brew install swiftlint
make ci

License

Released under the MIT License.