# pywinauto/pywinauto

Windows GUI Automation with Python (based on text properties)

Repository: https://github.com/pywinauto/pywinauto
Canonical: https://ross.abutalabs.com/products/pywinauto
Homepage: http://pywinauto.github.io/
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: python, automation, ui-automation, ui-automated-tests, windows, pywinauto, linux, gui, user-interface, testing-tools, testing, qa, uiautomation, python-library, hooks, windows-api, win32api
Last push: 2026-05-23T11:19:22+00:00

## Health v2 (maintenance only)
Score: 60/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 83, release rhythm 8, longevity 100
- inputs: {"age_days": 4118, "days_push": 102, "days_rel": 604, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6150, forks 789 (observed 2026-08-28T04:09:36.598035+00:00)

## What it is
pywinauto is a Python library for automating the Microsoft Windows GUI, sending mouse and keyboard actions to windows, dialogs, and controls based on text properties. It supports Win32 API and MS UI Automation backends, with mouse/keyboard emulation modules that also work on Linux.

## Use cases
- automate windows desktop application testing with python
- send mouse and keyboard input to windows dialogs programmatically
- write ui automated tests for win32 applications
- extract text data from windows controls
- script repetitive tasks in windows gui applications
- test desktop apps using ms ui automation backend

## When to avoid
- you need to automate macOS GUIs
- you are testing web applications in a browser
- you need a record-replay tool with a graphical recorder out of the box

## Facets
- artifact type: library
- maturity: active
- function: testing, workflow-automation, gui, developer-tools
- domain: testing, windows, developer-tools
- platform: windows, python
- tags: gui-automation, ui-automation, win32-api, desktop-testing, qa, mouse-keyboard-emulation, automation, linux

## Member repositories
- pywinauto/pywinauto (main) score 60

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:36.598035+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:47:32.062863+00:00, confidence not recorded.
  - readme: https://github.com/pywinauto/pywinauto (fetched 2026-08-28T04:09:36.598035+00:00, sha d8032bb5af6b)
  - registry_pypi: https://pypi.org/pypi/pywinauto/json (fetched 2026-08-29T08:44:20.843504+00:00, sha 4ce51ea4823e)
- Data as of 2026-08-30T08:39:29.467469+00:00.