Desktop Agent — Install & Permissions

Granting screen-recording permission

How to unblock tracking when the desktop app says screen capture or screenshot permission is missing.

The desktop agent cannot track billable work unless screenshot capture is available. If the app says Screenshot permission is missing or Tracking is blocked until screenshot permission is granted, fix the OS permission first.

macOS

Open System Settings → Privacy & Security → Screen Recording.
Enable Anastasis Desktop.
Quit the desktop app completely, then reopen it.
Click Refresh diagnostics in the app.

If your workflow uses helper automation, also check System Settings → Privacy & Security → Accessibility and allow the app there.

Windows

Windows does not expose the same live permission status to Electron. The app attempts capture directly and blocks only if capture fails. If it fails, check Privacy & security settings, any enterprise screen-recording policy, and restart the app.

Linux

On Wayland, make sure xdg-desktop-portal is installed and accept the screen-capture prompt. On X11, confirm your desktop session allows screen capture.

Confirm it worked

When permission is healthy, Permission gate should say Screenshot permission granted. Real screenshot capture is available. You can then use Start, Pause, and Stop under Tracking controls.