Installing with pip
moderngl-window is available on PyPI:
pip install moderngl-window
We try to have as few requirements as possible and instead offer optional dependencies. You can create your own window types and loaders and don’t want to force installing unnecessary dependencies.
By default we install pyglet as this is the default window type as it small and pretty much work out of the box on all platforms.
Optional dependencies for loaders:
# Wavefront / obj loading
pip install moderngl-window[pywavefront]
# STL loading
pip install moderngl-window[trimesh]
Installing dependencies for window types:
pip install moderngl-window[PySide2]
pip install moderngl-window[pyqt5]
pip install moderngl-window[glfw]
pip install moderngl-window[PySDL2]
Installing optional dependencies this way should ensure a compatible version is installed.
For glfw and sdl2 windows you also need install the library itself. Thees are also available as packages on linux and homebrew on OS X. For windows the DLLs can simply be placed in the root of your project.
Installing from source
# clone repo (optionally clone over https)
git clone email@example.com:moderngl/moderngl-window.git
# Create your virtualenv and activate
# We assume the user knows how to work with virtualenvs
# Install moderngl-window in editable mode
pip install -e .
# Install optional dev dependencies
pip install -e .[dev]
pip install -e .[docs]
Installing the package in editable mode will make you able to run tests and examples. We highly recommend using virtualenvs.
Assuming you installed from source you should be able to run the examples in the examples directory directly after installing the dev requirements in the root of the project.
Assuming dev requirements are installed.
Run tests with