Time Tracker

A macOS menu bar app that tracks your working hours and logs them to Google Sheets.

Features

• Menu bar app — lives in your menu bar, no dock icon
• Google SSO — sign in with your Google account (OAuth 2.0 with PKCE)
• Google Sheets integration — select any spreadsheet and tab to log time
• Auto-headers — automatically adds Date, Start Time, End Time, Description headers
• Inactivity detection — pauses after 15 minutes of no mouse/keyboard activity, resumes automatically
• Auto-start — launches on login and starts tracking immediately
• Saved actions — frequently used descriptions are saved for quick selection
• Hours summary — view today, this week, this month, all-time hours with daily/weekly averages
• Keychain storage — OAuth tokens stored securely, no need to re-login
• Notarized — signed with Developer ID and notarized by Apple, no Gatekeeper warnings

Install

1. Download TimeTracker.dmg from the latest release
2. Open the DMG and drag Time Tracker to Applications
3. Launch Time Tracker — it appears in your menu bar
4. Sign in with Google and select your spreadsheet

Sheet Format

The app logs entries with these columns:

Date	Start Time	End Time	Description
2026-03-09	9:00 AM	10:30 AM	Working on feature X

Requirements

• macOS 14.0 or later
• Google account with access to Google Sheets

Building from Source

1. Clone the repo
2. Open TimeTracker.xcodeproj in Xcode
3. Set your Development Team in Signing & Capabilities
4. Build and run

Notarized Distribution

# Store Apple ID credentials (one-time)
xcrun notarytool store-credentials "TimeTracker" \
    --apple-id "your@email.com" \
    --team-id "YOUR_TEAM_ID"

# Build, sign, notarize, and create DMG
./build-and-notarize.sh

License

MIT