Setup checklistProfile settings
Desktop Agent — Install & Permissions

Granting screen-recording permission

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

Contractors · 2 min read · updated 2026-09-30

¿Prefieres español? Lee esta guía en español.

The desktop agent cannot track billable work unless screenshot capture is available. If the app says Screen recording is off for Anastasis Desktop, fix the OS permission first.

macOS

Open System Settings → Privacy & Security → Screen Recording. The app’s Open System Settings button takes you straight there.
Enable Anastasis Desktop.
Quit the desktop app completely, then reopen it.
Click Check again 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 the app says Screen recording is enabled. You’re all set. and the status reads Granted. You can then Clock in; the timer shows Shift active, and Take a break pauses monitoring without billing the time.

En español

La app no puede registrar trabajo facturable sin poder tomar capturas de pantalla. Si la app dice La grabación de pantalla está desactivada para Anastasis Desktop, primero arregla el permiso del sistema.

macOS

Abre Configuración del Sistema → Privacidad y seguridad → Grabación de pantalla. El botón Abrir Configuración del Sistema de la app te lleva directo.
Activa Anastasis Desktop.
Cierra la app por completo y vuelve a abrirla.
Pulsa Verificar de nuevo en la app.

Windows

Windows no muestra este permiso igual que macOS. La app intenta capturar directamente y solo se detiene si falla. Si falla, revisa Privacidad y seguridad, cualquier política de tu empresa que bloquee la grabación de pantalla, y reinicia la app.

Linux

En Wayland, instala xdg-desktop-portal y acepta el aviso para compartir pantalla (elige tu pantalla completa). En X11 confirma que tu sesión permite capturar la pantalla.

Comprobar que funcionó

Con el permiso correcto, la app dice La grabación de pantalla está habilitada. Todo listo. y el estado es Concedido. Ya puedes pulsar Entrar; verás Jornada activa, y Tomar un descanso pausa el monitoreo sin cobrar ese tiempo.

Related
Still stuck?
Ask us here and a real person answers. We’ll notify you when they do.
Contact support