How to Install PyGetWindow in Python
A simple, cross-platform module for obtaining GUI information on application's windows.
pip install PyGetWindow
What is PyGetWindow?
A simple, cross-platform module for obtaining GUI information on application's windows.
A simple, cross-platform module for obtaining GUI information on and controlling application's windows.
Still under development. Currently only the Windows platform is implemented. If you want to help contribute, please contact al@inventwithpython.com!
(For this example, I'm using Windows and opened the Notepad application, which has a title of "Untitled - Notepad". Most of the effects of these functions can't be seen in text.)
Quick Start
Minimal example to get started with PyGetWindow:
import pygetwindow
print(pygetwindow.__version__)Installation
pip (standard)
pip install PyGetWindowVirtual environment (recommended)
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install PyGetWindowpip3
pip3 install PyGetWindowconda
conda install -c conda-forge PyGetWindowPoetry
poetry add PyGetWindowVerify the Installation
After installing, confirm the package is available:
python -c "import pygetwindow; print(pygetwindow.__version__)"If this prints a version number, installation succeeded. If you see a ModuleNotFoundError, see the errors section below.
Installation Errors
Common errors when installing PyGetWindow with pip.
ModuleNotFoundError: No module named 'pygetwindow'
Cause: The package is not installed in the current Python environment.
Fix: Run pip install PyGetWindow. If using a virtual environment, ensure it is activated first.
ModuleNotFoundError: No module named 'pygetwindow' (installed but still failing)
Cause: pip installed the package into a different Python than the one running your script.
Fix: Use python -m pip install PyGetWindow to install into the interpreter you are running.
ImportError: cannot import name 'X' from 'pygetwindow'
Cause: The function or class does not exist in the installed version.
Fix: Check the version with pip show PyGetWindow and upgrade with pip install --upgrade PyGetWindow.
pip: command not found
Cause: pip is not in PATH or Python was not added to PATH during installation.
Fix: Try python -m pip install PyGetWindow. On macOS/Linux try pip3.
PermissionError: [Errno 13] Permission denied
Cause: No write access to the system Python package directory.
Fix: Use a virtual environment, or add --user: pip install --user PyGetWindow
SSL: CERTIFICATE_VERIFY_FAILED
Cause: pip cannot verify PyPI's SSL certificate — common behind corporate proxies.
Fix: Try: pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org PyGetWindow
Recent Releases
| Version | Released |
|---|---|
0.0.9 latest |
2020-10-04 |
0.0.8 |
2019-11-13 |
0.0.7 |
2019-08-03 |
0.0.6 |
2019-06-18 |
0.0.5 |
2019-05-18 |
Manage PyGetWindow
Upgrade to latest version
pip install --upgrade PyGetWindowInstall a specific version
pip install PyGetWindow==0.0.9Uninstall
pip uninstall PyGetWindowCheck what is installed
pip show PyGetWindow