Skip to main content

Python SDL2 bindings

Project description

PySDL2

Tests PyPI - Python Version PyPI Version

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.sdlmixer module)
  • SDL2_ttf >= 2.0.14 (for the sdl2.sdlttf module)
  • SDL2_image >= 2.0.1 (for the sdl2.sdlimage module)
  • SDL2_gfx >= 1.0.3 (for the sdl2.sdlgfx module)

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pysdl2-0.9.17.tar.gz (776.0 kB view details)

Uploaded Source

Built Distribution

PySDL2-0.9.17-py3-none-any.whl (583.1 kB view details)

Uploaded Python 3

File details

Details for the file pysdl2-0.9.17.tar.gz.

File metadata

  • Download URL: pysdl2-0.9.17.tar.gz
  • Upload date:
  • Size: 776.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.8.12

File hashes

Hashes for pysdl2-0.9.17.tar.gz
Algorithm Hash digest
SHA256 48c6ef01a4eb123db5f7e46e1a1b565675755b07e615f3fe20a623c94735b52b
MD5 8dd193d3b01d949b256b5bb95c277dc6
BLAKE2b-256 d7ff8704d84ad4d25f0a7bf7912504f64575e432e8d57dfba2fe35f5b2db7e04

See more details on using hashes here.

File details

Details for the file PySDL2-0.9.17-py3-none-any.whl.

File metadata

  • Download URL: PySDL2-0.9.17-py3-none-any.whl
  • Upload date:
  • Size: 583.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.8.12

File hashes

Hashes for PySDL2-0.9.17-py3-none-any.whl
Algorithm Hash digest
SHA256 fe923dbf5c7b27bbc1eb2bf58abfa793f8f13fd7ae8b27b1bc2de49920bcbd41
MD5 0e258b87ed94199214f8bb6abd741ac5
BLAKE2b-256 5de2399ea7900e7510096aeb41439e6f1540bef0bdf7e15cc2d8464e4adb71e8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page