Skip to main content

PySDL2

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/marcusva/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 and Windows, 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 Linux and other Unix-like OSes, 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.

Release files for PySDL2 0.9.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for PySDL2 0.9.7
File Size Uploaded
PySDL2-0.9.7.tar.gz 1.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for PySDL2 0.9.7
File Interpreter ABI Platform
PySDL2-0.9.7-py3-none-any.whl Python 3 none any Details

Total release size: 1.6 MB

Release files / PySDL2-0.9.7.tar.gz

Download URL PySDL2-0.9.7.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
e4fcc8aa1108e4917cb56794575ee08c2a3d9c2c52620474e3ecc8538dadf209
BLAKE2b-256 checksum
How to use checksums
395821d31ceba68b7d8c06be5ee620264bc91a5a7c69b796a7c32aae9e8b10bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0

Release files / PySDL2-0.9.7-py3-none-any.whl

Download URL PySDL2-0.9.7-py3-none-any.whl
Size 541.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
35646eabee980ccc49f675e3de0aed9bf001045f46ecb6699a3c9ec074870141
BLAKE2b-256 checksum
How to use checksums
60baddb48261848874eeb3d54963edbf3c74fff86499746aeb23151f123953bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0

Release history Release notifications | RSS feed

0.9.17

2 release files

0.9.16

1 release file

0.9.15

1 release file

0.9.14

1 release file

0.9.13

1 release file

0.9.12

2 release files

0.9.11

2 release files

0.9.10

1 release file

0.9.9

2 release files

0.9.8

2 release files

This release

0.9.7 This release

2 release files

0.9.6

1 release file

0.9.5

2 release files

0.9.4

2 release files

0.9.3

1 release file

0.9.2

1 release file

0.9.1

1 release file

0.9.0

1 release file

0.8.0

0.7.0

0.6.0

0.5.0

0.4.1

0.4.0

0.3.0

0.2.0

0.1.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page