Screen Recording Permissions (Mac Only)

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.

Last updated