Need help with luasdl2?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

249 Stars 60 Forks ISC License 133 Commits 14 Opened issues


A pure C binding of SDL 2.0 for Lua 5.1, Lua 5.2, and LuaJIT.

Services available


Need anything else?

Contributors list

Lua-SDL2 (SDL2 binding for Lua)

Lua-SDL2 is a pure C binding of SDL2 to Lua 5.1, Lua 5.2, Lua 5.3, Lua 5.4, and LuaJIT.

The current version is 2.1, compatible with SDL 2.0.1 - 2.0.5.

Lua-SDL2 follows the SemVer standard with regards to project versioning.


Lua-SDL2 is a portable binding of SDL2, written in pure C for efficiency. It tries to stay as close to SDL as possible, acting as a simple binding rather than attempting to re-design the interaction between the programmer and SDL.

Lua-SDL2 takes full advantage of Lua's object-oriented capabilities wherever possible, allowing the programmer to fully leverage SDL's inherent object-oriented design.

Lua-SDL2 is very well documented, with copious source-code comments, and a full API reference available at the wiki.


Lua-SDL2 is designed to be as compatible as possible. The library has support for all the latest features of SDL2, while still compiling with SDL 2.0.1.

If the library is compiled with a newer point release of SDL than what is listed here, the library should still function, simply without access to the newer features.

Lua-SDL2 is compatible with:

* Lua 5.1, 5.2, 5.3, 5.4 or LuaJIT
* SDL 2.0.1 and greater


If you have LuaRocks installed,

$ luarocks install lua-sdl2

Otherwise, read
for instructions to build it yourself.


The official website is hosted at

The current documentation is available at the associated wiki.

Author and Maintainer

The Lua-SDL2 library was written by David Demelier.

It is currently being maintained by Joseph Wallace.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.