MACOS ALPHA

Running Workforce Time Tracker on macOS

The Mac client remains alpha, released alongside Windows with the same licence and data services. It uses native window controls and its own layout; Windows compact view and the More menu are not available on Mac. Both clients can use the same shared-data folder managed by your chosen sync provider.

What "alpha" means here

  • Core workflow: tracking, customer pick, week calendar, idle prompt, PDF invoicing, CSV import all work on Mac.
  • One license: the same activation key works on Windows and Mac.
  • Portable local data: the macOS client writes the same JSON formats as Windows. Stop tracking and close both apps before copying a data folder Win ↔ Mac.
  • Ad-hoc signed, not Apple-notarized. Gatekeeper can block first launch until you approve it (see step 3 below). Apple Developer signing and notarization have not been configured.
  • Active-window detection requires Accessibility permission. Without it, manual time tracking still works fully.
  • Known rough edges: Login Item registration still needs hands-on verification. If auto-start does not stick, toggle it off and on once and report back.
  • If you hit anything weird, email [email protected] with a short repro.
Mac app at minimum window size, with customer selection, timer, calendar and export controls
The Mac interface in your system theme. At minimum window size, scroll to reach the settings and licence controls.

Install in 4 steps

1Download the .dmg

Get the latest Mac build from the download page. Choose the Apple Silicon DMG package.

2Drag the app into Applications

Open the .dmg and drag Workforce Time Tracker.app into the Applications folder shortcut shown in the Finder window. Then eject the .dmg.

3Approve the first launch (Gatekeeper)

The first time you open the app, macOS will refuse to run it because it is not Apple-notarized. This is normal for ad-hoc-signed builds.

  1. Right-click Workforce Time Tracker.app in your Applications folder, then choose Open.
  2. Click Open in the dialog that appears.
  3. If macOS still refuses, open System Settings → Privacy & Security. Scroll to the bottom - you will see "Workforce Time Tracker was blocked..." with an Open Anyway button. Click it, then re-launch the app.

You only need to do this once. After approval, future launches work normally.

4Grant Accessibility permission (optional but recommended)

Without this, the app cannot read window titles - so auto-tracking, suggestion banners, and CRM auto-start will be inactive. Manual time tracking still works.

  1. The app shows a yellow banner on launch when permission is missing - click Open System Settings.
  2. Under Privacy & Security → Accessibility, click the + button.
  3. Browse to /Applications/Workforce Time Tracker.app and add it.
  4. Make sure the toggle next to it is ON.
  5. Restart the app.

Where your data lives

All settings, customers, and time entries are stored locally in:

~/Library/Application Support/WorkforceTimeTracker/

You can open this folder anytime from Settings → Data → Open. The JSON files in there are byte-compatible with the Windows version - copy them across machines or platforms freely.

One license, both platforms

Your license key activates the same on macOS and Windows. There is no separate Mac SKU and no extra cost for cross-platform use.

Reporting alpha bugs

Send a short note to [email protected] with:

Optional but very helpful: attach ~/Library/Application Support/WorkforceTimeTracker/settings.json with any sensitive bits redacted.

When does it stop being alpha?

The Mac build moves from alpha to stable when:

There is no committed date for the next Mac release. Check the release notes for published changes; the Mac download remains labelled alpha until these criteria are met.

Back to downloads