Wait 2 seconds to switch to the target window

In the previous tutorial, we covered how to install and configure PyAutoGUI. Now, we’ll dive deeper into using PyAutoGUI for fundamental desktop application automation tasks. With these basic operations, you can automate simple, repetitive tasks—boosting your productivity.

Overview of PyAutoGUI Basic Operations

PyAutoGUI is a powerful Python library for simulating mouse and keyboard actions. It enables automation of desktop applications, making repetitive tasks significantly easier. Below, we demonstrate common operations such as moving the mouse, clicking, typing text, and triggering keyboard shortcuts.

1. Importing the Library

Before using PyAutoGUI, import it into your script. Ensure you’ve completed the installation steps from the previous lesson.

import pyautogui
import time

2. Moving the Mouse

You can move the mouse using the moveTo() and move() methods:

• moveTo(x, y, duration): Moves the mouse to screen coordinates (x, y) over duration seconds (optional).
• move(dx, dy, duration): Moves the mouse relative to its current position by dx pixels horizontally and dy pixels vertically.

Example Code:

# Wait 2 seconds to switch to the target window
time.sleep(2)

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

3. Clicking the Mouse

The click() method simulates mouse clicks. You can specify left-click (default) or right-click.

Example Code:

# Left-click (no arguments needed)
pyautogui.click()

# Right-click
pyautogui.click(button='right')

4. Typing Text

Use typewrite() to input text rapidly. It supports an interval parameter to control the delay between keystrokes.

Example Code:

# Type text with a 0.25-second delay between each character
# (Wait 1 second first to ensure the target text field is focused)
pyautogui.typewrite('Hello, World!', interval=0.25)

5. Keyboard Shortcuts

The hotkey() method simulates simultaneous key presses—for example, copy (Ctrl+C) or paste (Ctrl+V).

Example Code:

# Simulate Ctrl+C (copy)
pyautogui.hotkey('ctrl', 'c')

# Simulate Ctrl+V (paste)
pyautogui.hotkey('ctrl', 'v')

6. Taking Screenshots

Although our focus is automation, PyAutoGUI also supports screenshot capture—a valuable tool for debugging and verifying automation results.

# Capture and save a screenshot
screenshot = pyautogui.screenshot()
screenshot.save('screenshot.png')

7. Complete Example

Below is a full working example that opens Notepad (on Windows), types text, and saves the file.

import pyautogui
import time
import subprocess

# Launch Notepad (Windows only)
subprocess.Popen(['notepad.exe'])
time.sleep(2)

# Type text with 0.1-second intervals between keystrokes
pyautogui.typewrite('This is an automated text input example!', interval=0.1)

# Trigger Ctrl+S to open the Save dialog
pyautogui.hotkey('ctrl', 's')
time.sleep(1)

# Type filename and confirm with Enter
pyautogui.typewrite('example.txt', interval=0.1)
pyautogui.press('enter')

Summary

In this lesson, we explored core PyAutoGUI operations—including mouse movement, clicking, text input, and keyboard shortcut simulation. These fundamentals lay the groundwork for more advanced capabilities like image recognition and region-based interaction.

In the next tutorial, we’ll delve into PyAutoGUI’s image recognition features to enable more sophisticated, context-aware automation.

We hope this introduction helps you get started with PyAutoGUI and simplifies your desktop automation workflows! Feel free to ask questions if anything is unclear.