Install on a Mac

Download the WorkMonitor build, sign in with your browser, and grant two macOS permissions to get this Mac tracking your work.

Who this is for

Anyone who needs WorkMonitor running on their own Mac. There's no permission gate on the download screen. Any signed-in member can reach it and enroll their own machine.

Before you start

• You sign in in your browser, the way you normally sign in to WorkMonitor — including Google, Microsoft or your company's single sign-on. Email and password, and an install token if your admin gave you one, are still there under Other ways to connect.
• macOS will ask you to approve two permissions partway through setup: Screen Recording and Accessibility. Nothing is captured until you grant both.

Steps

1. In the sidebar, select Get the agent.
2. Check the build selected under Install on another OS. WorkMonitor detects your Mac and shows a Detected badge (for example, "you're on macOS · Apple silicon"); if it guessed wrong, select the other chip yourself: macOS · Apple silicon or macOS · Intel.
3. Select Download for macOS · Apple silicon (or · Intel). The version, file format, size, and whether the build is Code-signed show underneath the button.
4. Open the downloaded file and launch WorkMonitor.
5. Click through the short intro (Begin, then Next), which explains the menu-bar indicator that stays visible the whole time you're tracked.
6. On Connect this Mac, select Sign in with your browser. Your browser opens on a WorkMonitor page: sign in there, check the computer and account it names, and select Connect. WorkMonitor on the Mac then asks Connect as [your name]? — select Connect to finish, or Not me if that isn't your account. There's nothing to copy across. (Prefer not to use the browser? Select Other ways to connect for email and password, or Use an install token instead.)
7. On Finish setup, select Allow next to Screen Recording, then Allow next to Accessibility. macOS shows its own confirmation dialog each time. Approve both.
8. Once both rows read On, select Start tracking.

What happens next

WorkMonitor drops to the menu bar and opens its live panel, showing a running timer and today's stats. It keeps running quietly in the menu bar from here. Quitting it is a separate, deliberate action from the tray's right-click menu, not something setup does for you.

If it doesn't work

• If your workspace hasn't published a macOS build yet, the download button is replaced by a panel that reads: "The macOS build isn't published to this workspace yet. Once a release publishes it, it downloads straight from here and this page tells you exactly what macOS will show when you open it."
• If Screen Recording still shows as needing permission after you select Allow, quit WorkMonitor (right-click the menu-bar icon and select Quit WorkMonitor), then reopen it. Screen Recording only takes effect after a relaunch.
• If your browser doesn't open, WorkMonitor shows Open this link in your browser with the link and a Copy link button. Open it yourself, and don't send it to anyone.
• "That request expired. Start again." means you took longer than the request lives. Select Sign in with your browser again.
• "Couldn't reach the workspace. Check your connection, or the server under Advanced." is a network problem, or the wrong address. Advanced sits next to the line naming the workspace on the first screen.
• Signing in with email and password instead can fail with "Invalid email or password." or "This account can't add a device here." Each points at what to check first.

Related

• Sign in with your browser
• The menu-bar icon and pausing
• Your devices