PySDL2
PySDL2 is a pure Python wrapper around the SDL2, SDL2_mixer, SDL2_image, SDL2_ttf, and SDL2_gfx libraries. Instead of relying on C code, it uses the built-in ctypes module to interface with SDL2, and provides simple Python classes and wrappers for common SDL2 functionality.
Installation
PySDL2 is easy to install and integrate within your own projects. To install or update to the latest version, simply run one of the following commands in a terminal:
# Install latest stable version from PyPI
pip install -U pysdl2
# Install latest development verion from GitHub
pip install -U git+https://github.com/py-sdl/py-sdl2.git
Note: If installing on Python 3 on a computer where both Python 2 and 3
are installed, replace pip with pip3 in the above commands.
Requirements
In order for PySDL2 to work, the binaries for SDL2 (and any SDL2 addon modules
you wish to use, e.g. SDL2_mixer) need to be installed on your system. On
macOS, Windows, and most x86 and ARM64 distributions of Linux, the recommended
way to install the SDL2 binaries is via the pysdl2-dll package using pip:
pip install pysdl2-dll
This will install pre-built binaries for all supported SDL2 libraries as
a Python package, which PySDL2 will automatically load if available.
On systems not supported by pysdl2-dll, you can install the SDL2 binaries using
your system's package manager (which may be out of date), or alternatively
build and install the latest versions yourself from source.
The current minimum supported versions for each library are listed below:
- SDL2 >= 2.0.5
- SDL2_mixer >= 2.0.1 (for the
sdl2.sdlmixermodule) - SDL2_ttf >= 2.0.14 (for the
sdl2.sdlttfmodule) - SDL2_image >= 2.0.1 (for the
sdl2.sdlimagemodule) - SDL2_gfx >= 1.0.3 (for the
sdl2.sdlgfxmodule)
Documentation
If you just started with SDL and PySDL2, it is strongly recommended
that you read through the tutorial of the documentation to learn the
basics. You can find the documentation at doc/html or online at
http://pysdl2.readthedocs.org.
License
This library is given to the public domain. There are no licensing
restrictions. Please see doc/copying.rst for further details.
Release files for PySDL2 0.9.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pysdl2-0.9.17.tar.gz | 776.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| PySDL2-0.9.17-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / pysdl2-0.9.17.tar.gz
| Download URL | pysdl2-0.9.17.tar.gz |
|---|---|
| Size | 776.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
48c6ef01a4eb123db5f7e46e1a1b565675755b07e615f3fe20a623c94735b52b
|
|
BLAKE2b-256 checksum How to use checksums |
d7ff8704d84ad4d25f0a7bf7912504f64575e432e8d57dfba2fe35f5b2db7e04
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.8.12
|
Release files / PySDL2-0.9.17-py3-none-any.whl
| Download URL | PySDL2-0.9.17-py3-none-any.whl |
|---|---|
| Size | 583.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe923dbf5c7b27bbc1eb2bf58abfa793f8f13fd7ae8b27b1bc2de49920bcbd41
|
|
BLAKE2b-256 checksum How to use checksums |
5de2399ea7900e7510096aeb41439e6f1540bef0bdf7e15cc2d8464e4adb71e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.8.12
|
