Metadata-Version: 2.1
Name: appwindows
Version: 1.3.0
Summary: The appwindows library provides a unified way to find, inspect, and control application windows across Windows, macOS, and Linux.
Author-Email: "Terochkin A.S" <apparser.development@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Environment :: X11 Applications
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: MacOS X :: Aqua
Classifier: Typing :: Stubs Only
Project-URL: Repository, https://github.com/lexter0705/appwindows
Project-URL: Issues, https://github.com/lexter0705/appwindows/issues
Project-URL: Docs, https://apparser.gitbook.io/appwindows
Requires-Python: >=3.8
Requires-Dist: numpy>=2.0
Description-Content-Type: text/markdown

<img src="https://raw.githubusercontent.com/lexter0705/appwindows/refs/heads/master/appwindows.svg" alt="" width="40%" >

[![License - BSD 3-Clause](https://img.shields.io/pypi/l/appwindows.svg)](https://github.com/lexter0705/appwindows/blob/master/LICENSE.md) [![unit_tests](https://github.com/lexter0705/appwindows/actions/workflows/unit_tests.yml/badge.svg)](https://github.com/lexter0705/appwindows/actions/workflows/unit_tests.yml)
<br>
[![PyPI Downloads](https://static.pepy.tech/personalized-badge/appwindows?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/appwindows) 
[![Documentation](https://img.shields.io/badge/docs-gitbook-green)](https://apparser.gitbook.io/appwindows)
<br>
[![PyPi](https://img.shields.io/badge/PyPi-link-green)](https://pypi.org/project/appwindows/)
[![Github](https://img.shields.io/badge/github-repo-green)](https://github.com/lexter0705/appwindows)
[![Issues](https://img.shields.io/badge/github-issues-green)](https://github.com/lexter0705/appwindows/issues)



# Appwindows
The appwindows library provides a unified way to find, inspect, and control application windows across Windows, macOS, and Linux.

# Supported platforms:
1) Windows
2) MacOs
3) Linux with XServer (Wayland works, but with very significant limitations)

# Install
```bash
pip install appwindows
```

# Examples

1) Resize window
```python
from appwindows import get_finder
from appwindows.geometry import Size

finder = get_finder()

window = finder.get_window_by_title("Some title")

window.resize(Size(width=200, height=200))
```

2) Move window
```python
from appwindows import get_finder
from appwindows.geometry import Point

finder = get_finder()

window = finder.get_window_by_title("Some title")

window.move(Point(x=200, y=200))
```

3) Get window coordinates and size
```python
from appwindows import get_finder

finder = get_finder()

window = finder.get_window_by_title("Some title")

points = window.get_points()
size = window.get_size()

print(points.left_top) # appwindows.geometry.Point(x=200, y=200)
print(size)            # appwindows.geometry.Size(width=200, height=200)
```

# Docs
All documentation <a href="https://apparser.gitbook.io/appwindows">here</a> <br>
Link to <a href="https://pypi.org/project/appwindows/">PyPi</a>
# For Developers
1) If something doesn't work - open issue.
2) If you want something fixed - open issue.
3) If you can help with the library - email.

apparser.development@gmail.com

Any help in development is welcome)!


