zoom_in Click to enlarge

PyAutoGUI

▲ ▼

language

description PyAutoGUI Overview

PyAutoGUI is a free, open source Python library facilitating automated control of a computer's graphical user interface. It allows developers to script actions like mouse movement and keyboard input across various operating systems. This tool is particularly useful for automating repetitive tasks within desktop applications, testing software, or creating custom scripts for specific workflows. It’s designed for users comfortable with Python programming.

help PyAutoGUI FAQ

Can PyAutoGUI find and click an image on the screen?

Yes. Functions such as locateOnScreen() and click() can search for a reference image and interact with its location. OpenCV can be installed to enable confidence-based matching rather than requiring an exact pixel match.

How do you stop a runaway PyAutoGUI script?

PyAutoGUI enables a fail-safe by default: moving the pointer into a corner of the primary screen causes the next PyAutoGUI call to raise FailSafeException. It also inserts a default 0.1-second pause after calls, giving the user a chance to trigger that escape.

Does PyAutoGUI work on Windows, macOS, and Linux?

Yes, the library supports all three desktop operating-system families. Scripts can still behave differently because screen coordinates, scaling, keyboard layouts, permissions, and application appearance vary between machines.

Can PyAutoGUI automate an application running in the background?

Not reliably in the way an application API can. PyAutoGUI drives visible mouse, keyboard, and screenshot interactions, so windows generally need to be displayed and positioned as the script expects.

swap_horiz

Looking for PyAutoGUI alternatives? Compare top competitors ranked & scored

arrow_forward