{"id":13993829,"url":"https://github.com/py-sdl/py-sdl2","last_synced_at":"2025-07-22T18:31:59.485Z","repository":{"id":36982431,"uuid":"100607832","full_name":"py-sdl/py-sdl2","owner":"py-sdl","description":"Python ctypes wrapper around SDL2","archived":false,"fork":false,"pushed_at":"2023-12-16T02:13:04.000Z","size":1968,"stargazers_count":293,"open_issues_count":18,"forks_count":49,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-08-10T14:14:37.835Z","etag":null,"topics":["python","sdl2","sdl2-gfx","sdl2-image","sdl2-mixer","sdl2-ttf"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/py-sdl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.txt","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-17T13:43:47.000Z","updated_at":"2024-08-09T08:44:53.000Z","dependencies_parsed_at":"2023-12-16T01:28:17.877Z","dependency_job_id":"16105dc6-d5c8-42be-997b-3d6c83134eab","html_url":"https://github.com/py-sdl/py-sdl2","commit_stats":{"total_commits":603,"total_committers":40,"mean_commits":15.075,"dds":0.6334991708126037,"last_synced_commit":"5b6a783d3eeab1198d958360e620f12249489ff4"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/py-sdl%2Fpy-sdl2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/py-sdl%2Fpy-sdl2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/py-sdl%2Fpy-sdl2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/py-sdl%2Fpy-sdl2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/py-sdl","download_url":"https://codeload.github.com/py-sdl/py-sdl2/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227156347,"owners_count":17739281,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","sdl2","sdl2-gfx","sdl2-image","sdl2-mixer","sdl2-ttf"],"created_at":"2024-08-09T14:02:34.524Z","updated_at":"2024-11-29T15:31:17.049Z","avatar_url":"https://github.com/py-sdl.png","language":"Python","readme":"# PySDL2\n\n[![Tests](https://github.com/py-sdl/py-sdl2/actions/workflows/run_tests.yml/badge.svg)](https://github.com/py-sdl/py-sdl2/actions/workflows/run_tests.yml)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pysdl2)\n[![PyPI Version](https://img.shields.io/pypi/v/PySDL2.svg)](https://pypi.python.org/pypi/PySDL2)\n\nPySDL2 is a pure Python wrapper around the SDL2, SDL2\\_mixer, SDL2\\_image,\nSDL2\\_ttf, and SDL2\\_gfx libraries.\nInstead of relying on C code, it uses the built-in ctypes module to interface\nwith SDL2, and provides simple Python classes and wrappers for common\nSDL2 functionality.\n\n## Installation\n\nPySDL2 is easy to install and integrate within your own projects.\nTo install or update to the latest version, simply run one of the\nfollowing commands in a terminal:\n\n```bash\n# Install latest stable version from PyPI\npip install -U pysdl2\n\n# Install latest development verion from GitHub\npip install -U git+https://github.com/py-sdl/py-sdl2.git\n```\n\n**Note**: If installing on Python 3 on a computer where both Python 2 and 3\nare installed, replace `pip` with `pip3` in the above commands.\n\n## Requirements\n\nIn order for PySDL2 to work, the binaries for SDL2 (and any SDL2 addon modules\nyou wish to use, e.g. SDL2\\_mixer) need to be installed on your system. On\nmacOS, Windows, and most x86 and ARM64 distributions of Linux, the recommended\nway to install the SDL2 binaries is via the `pysdl2-dll` package using pip:\n\n```bash\npip install pysdl2-dll\n```\n\nThis will install pre-built binaries for all supported SDL2 libraries as\na Python package, which PySDL2 will automatically load if available.\nOn systems not supported by `pysdl2-dll`, you can install the SDL2 binaries using\nyour system's package manager (which may be out of date), or alternatively\nbuild and install the latest versions yourself from source.\n\nThe current minimum supported versions for each library are listed below:\n\n* **SDL2** \u003e= 2.0.5\n* **SDL2_mixer** \u003e= 2.0.1 (for the `sdl2.sdlmixer` module)\n* **SDL2_ttf** \u003e= 2.0.14 (for the `sdl2.sdlttf` module)\n* **SDL2_image** \u003e= 2.0.1 (for the `sdl2.sdlimage` module)\n* **SDL2_gfx** \u003e= 1.0.3 (for the `sdl2.sdlgfx` module)\n\n## Documentation\n\nIf you just started with SDL and PySDL2, it is strongly recommended\nthat you read through the tutorial of the documentation to learn the\nbasics. You can find the documentation at `doc/html` or online at\n\u003chttp://pysdl2.readthedocs.org\u003e.\n\n## License\n\nThis library is given to the public domain. There are no licensing\nrestrictions. Please see `doc/copying.rst` for further details.\n","funding_links":[],"categories":["Game Development","Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpy-sdl%2Fpy-sdl2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpy-sdl%2Fpy-sdl2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpy-sdl%2Fpy-sdl2/lists"}