Time Tracker is a native macOS application for recording time against projects and tasks.
- Open
Time Tracker.xcodeproj. - Select the Time Tracker scheme and My Mac as the run destination.
- Choose Product > Run (⌘R). Xcode builds and launches the application.
The project currently targets macOS 12.0 or later.
Download the latest ZIP from the GitHub Releases page, then open it to extract Time Tracker.app. You can move the app to Applications.
The release build is ad-hoc signed and is not notarized by Apple. The first time you open it, macOS may block it:
- Try to open Time Tracker once from Finder.
- Open Apple menu > System Settings > Privacy & Security and scroll to the Security section.
- Click Open Anyway for Time Tracker, then confirm Open in the next alert.
Only do this if you downloaded the app from the project's GitHub Releases page and trust its source. Once approved, you can open it normally from Applications or Finder. See Apple's instructions for details.
With Xcode and its command-line tools installed, build the app from the repository root:
xcodebuild \
-project "Time Tracker.xcodeproj" \
-scheme "Time Tracker" \
-configuration Debug \
-destination 'platform=macOS' \
-derivedDataPath build \
buildLaunch the built app with:
open "build/Build/Products/Debug/Time Tracker.app"- Create a project using New Project in the toolbar.
- Select the project, then create a task in it.
- Select the task and click the green recording button to start tracking time.
The menu bar status item can start and stop recently used tasks. The number of recent tasks is configurable in the application settings.
Time records are stored in ~/Library/Application Support/TimeTracker/data.plist. Back up this file to preserve recorded data. The application can export records to CSV; it does not import XLS or CSV files.
See HACKING.txt for the developer workflow and current release packaging and publishing steps.