Metadata-Version: 2.4
Name: pyvisionauto
Version: 0.1.0
Summary: PyVisionAuto: Linux end-to-end automation toolkit with visual image matching, mouse/keyboard control, and screen recording
Author: PyVisionAuto contributors
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://pypi.org/project/pyvisionauto/
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: X11 Applications
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opencv-python>=4.8.0
Requires-Dist: mss>=9.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: pyautogui>=0.9.54
Requires-Dist: pillow>=10.0.0
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Dynamic: license-file

# PyVisionAuto

PyVisionAuto (`pyvisionauto`) is a Linux end-to-end automation testing toolkit.
It is centered on visual image matching and also includes screen recording, mouse automation, and keyboard automation capabilities.

## Scope

- Linux only
- X11 session only
- Real physical display required

## Install

```bash
pip install pyvisionauto
```

## System dependencies

- python3-tk (for border overlay highlight)
- xdotool (preferred for window activation)
- wmctrl (fallback for window activation)
- ffmpeg (optional, only for recording APIs)

## Quick start

```python
from pyvisionauto import Screen

screen = Screen()
screen.wait("login_button.png", timeout=10).highlight().click()
```

## Notes

Wayland-first and headless-only environments are not supported in v0.1.
