LogoLogo
  • Overview
    • Quickstart
    • FAQ
    • Overview
    • Pricing
    • Comparison
    • Discord
  • Pro Setup
    • Book a Demo
    • 30x30 Promotion
  • Guides
    • Generate a Test Suite
    • Local Agent Setup
    • Prompting
    • Getting an API Key
    • GitHub Actions
      • GitHub Action Setup
      • Prerun Scripts
      • Environment Config
      • Parallel Testing
      • Storing Secrets
      • Optimizing Performance
      • Action Output
      • Examples
        • Test Generation
        • Parallel Testing
        • Importing Tests
        • Desktop Apps
        • Secure Log In
    • Debugging Test Runs
    • Monitoring Performance
  • Reference
    • Test Steps
      • assert
      • exec
      • focus-application
      • hover-image
      • match-image
      • hover-text
      • if
      • press-keys
      • remember
      • run
      • scroll
      • scroll-until-image
      • scroll-until-text
      • type
      • wait
      • wait-for-image
      • wait-for-text
    • Interactive Commands
      • /assert
      • /undo
      • /save
      • /run
      • /generate
    • CLI
      • testdriverai init
      • testdriverai [file]
      • testdriverai run [file]
  • Security & Privacy
    • Agent
    • Action
    • Dashboard
  • FAQ
    • Screen Recording Permissions (Mac Only)
    • Status Page
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. FAQ

Screen Recording Permissions (Mac Only)

PreviousDashboard

Last updated 7 months ago

Was this helpful?

If you're on mac, you might see an error related to "screen capture permissions" when getting started. This means that the application invoking the `testdriverai` command does not have permission to capture.

You must enable screen capture permissions for this application

This might be a little confusing at first. It's not testdriverai that needs the permissions, it's the terminal or IDE that's calling testdriverai that needs them. This is probably:

  • Mac Terminal

  • iTerm

  • VS Code

  • Or something similar

Enable Screen Capture Permissions for TestDriver

To enable screen capture permissions, do the following.

  • Open System Settings (or System Preferences on older versions).

  • Navigate to Privacy & Security > Screen Recording.

  • Find and enable permissions for Terminal (or any terminal-based app like iTerm2, if you're using it).

  • If the desired application is unavailable in the list, click on "+" symbol below, you will get a finder pop up, here find the app that you are currently using under Application section and click on open.

  • You may need to restart the terminal for the changes to take effect.

Privacy & Security > Screen & System Audio Recording
Click the toggle button to enable screen capture permissions.