Metadata-Version: 2.1
Name: PyGB
Version: 0.9.54
Summary: PyGB lets Python control the mouse and keyboard, and other GUI automation tasks. For Windows, macOS, and Linux, on Python 3 and 2.
Home-page: https://github.com/danalites/pygb
Author: Al Sweigart, and other contributors
Author-email: al@inventwithpython.com
License: BSD
Keywords: gui automation test testing keyboard mouse cursor click press keystroke control
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: X11 Applications
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
License-File: AUTHORS.txt

PyGB
=========

PyGB (Py-GUI-Background) is a fork of the PyAutoGUI to support background keyboard and mouse events to a specific window.

### Getting Started
Everything is the same as in the original PyAutoGUI, except for each function you can add a `window` argument to specify the window to send the event to (the window can be inactive, running in the background).

If the `window` argument is not specified, the event will be sent to the global event tap (same as original PyAutoGUI).

```python
import pygb

# Press key to a specific window
pygb.keyDown('a', window=859)
pygb.keyUp('a', window=859)

# Take screenshot of a specific window
img = pygb.screenshot('a', window=859)
```

## Window APIs

### `pygb.getWindows()` 
- returns a list of windows with their title

### Window resizing 
- `win.resize(width, height)` - resize a window to a specific size: https://stackoverflow.com/questions/70535283/how-can-i-resize-terminal-window-from-python

### References
- [cocoa-vanilla](https://github.com/robotools/vanilla): a Python library for building Cocoa GUIs on macOS
- [ahk-python](https://github.com/spyoungtech/ahk)
