Pause for 2 seconds to allow you to switch to the target application

In the previous tutorial, we delved into using Selenium for web automation—particularly techniques for handling dynamic web pages. This tutorial guides you through desktop application automation with PyAutoGUI, beginning with the essential steps of correctly installing and configuring the PyAutoGUI library.

What Is PyAutoGUI?

PyAutoGUI is a Python library designed for automating desktop application interactions. With it, you can control the mouse and keyboard, as well as capture screenshots. This powerful tool enables simulation of human user behavior—making it ideal for automated testing, repetitive task execution, and more.

Installing PyAutoGUI

Ensure that Python is already installed on your system (Python 3.6 or later is recommended), then follow these steps to install the PyAutoGUI library.

1. Install Using pip

Open your terminal or command prompt and run the following command:

pip install pyautogui

This command downloads and installs the latest version of PyAutoGUI from the Python Package Index (PyPI).

2. Install Dependencies

Depending on your operating system, PyAutoGUI may require additional dependencies:

• Windows: No extra dependencies are needed.
• macOS: You may need to install Pillow:

  pip install Pillow
  

• Linux: You must first install xdotool and Pillow. Use the following commands:

  sudo apt-get install xdotool
  pip install Pillow
  

3. Verify Installation

After installation, verify that PyAutoGUI was successfully installed by running the following code in a Python interactive session or a new .py file:

import pyautogui

print(pyautogui.__version__)

If you see a version number output—e.g., 0.9.53—then PyAutoGUI has been installed correctly.

Environment Configuration

While PyAutoGUI requires no special environment configuration, it’s considered best practice to ensure no other applications interfere with its operations—for example, avoid having overlapping windows or background processes that might capture input unexpectedly.

Example: A Simple PyAutoGUI Usage

Once installed, we’ll explore basic operations in the next tutorial—but here’s a quick example to give you an initial sense of PyAutoGUI’s capabilities:

import pyautogui
import time

# Pause for 2 seconds to allow you to switch to the target application
time.sleep(2)

# Get current mouse position
current_mouse_x, current_mouse_y = pyautogui.position()
print(f"Current mouse position: ({current_mouse_x}, {current_mouse_y})")

# Move mouse to coordinates (100, 100) over 1 second
pyautogui.moveTo(100, 100, duration=1)

# Click the mouse
pyautogui.click()

In this example, the script pauses briefly so you can manually switch to the target application window. It then retrieves the current mouse position, moves the cursor to (100, 100) smoothly over one second, and performs a single mouse click.

Summary

We’ve now completed the installation and basic setup of PyAutoGUI. In the next article, we’ll dive deeper into practical examples of fundamental desktop automation tasks using PyAutoGUI. Stay tuned!