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.

Privacy & Security > Screen & System Audio Recording

Click the toggle button to enable screen capture permissions.