Skip to main content

A cross-platform module for GUI automation for human beings. Control the keyboard and mouse from a Python script.

Project description

pyautogui

A cross-platform GUI automation Python module for human beings. Used to programmatically control the mouse & keyboard.

This module seeks to replace PyUserInput, PyKeyboard, PyMouse, pykey, and pyhook. See the roadmap in the documentation.

NOTE - It is a known issue that the keyboard-related functions don’t work on Ubuntu VMs in Virtualbox.

Example Usage

>>> import pyautogui
>>> screenWidth, screenHeight = pyautogui.size()
>>> currentMouseX, currentMouseY = pyautogui.position()
>>> pyautogui.moveTo(100, 150)
>>> pyautogui.click()
>>> pyautogui.moveRel(None, 10)  # move mouse 10 pixels down
>>> pyautogui.doubleClick()
>>> pyautogui.moveTo(500, 500, duration=2, tween=pyautogui.tweens.easeInOutQuad)  # use tweening/easing function to move mouse over 2 seconds.
>>> pyautogui.typewrite('Hello world!', interval=0.25)  # type with quarter-second pause in between each key
>>> pyautogui.press('esc')
>>> pyautogui.keyDown('shift')
>>> pyautogui.press('left', 'left', 'left', 'left', 'left', 'left')
>>> pyautogui.keyUp('shift')
>>> pyautogui.hotkey('ctrl', 'c')

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyAutoGUI-0.9.0.zip (35.8 kB view details)

Uploaded Source

File details

Details for the file PyAutoGUI-0.9.0.zip.

File metadata

  • Download URL: PyAutoGUI-0.9.0.zip
  • Upload date:
  • Size: 35.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for PyAutoGUI-0.9.0.zip
Algorithm Hash digest
SHA256 a73627ba1dd4c1029a5324b3f75f1143777e9ca28f1c75082b33202e2b8dd610
MD5 49534592c24267ee1f6ee1030936463f
BLAKE2b-256 12626d1222a6f19ed7775fa7a343ddae0d7de60f2338499399d68dc8b7a39432

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page