Bindings for SDL3 in Rust.
SDL is the Simple Directmedia Library, a cross-platform library to abstract the platform-specific details for building applications. It takes care of everything from handling events, creating windows, playing audio, accessing device cameras and sensors, locking, GPU access, and much more. See more here: https://wiki.libsdl.org/SDL3/APIByCategory.
SDL officially supports Windows, macOS, Linux, iOS, and Android, and several other platforms.
Now that the SDL3 API is mostly stabilized, we are working on a new version of the Rust bindings for SDL3. The migration is in progress, and we are looking for contributors to help us complete it.
Expect some bugs and missing features. Feel free to create issues or work on them yourself.
- Update all modules to SDL3, use new sdl3-sys bindings, follow migration guide.
- Fix tests.
- Update examples to SDL3.
- Add new features from SDL3.
- Update documentation.
Please refer to the sdl3-rs repository for the latest updates.
The low-level bindings are being worked on in the sdl3-sys repository.
This is an interface to use SDL3 from Rust.
Low-level C components are wrapped in Rust code to make them more idiomatic and abstract away inappropriate manual memory management.
Add the following to your Cargo.toml:
[dependencies]
sdl3 = { version = "0", features = [] }Or if you would like to open it offline, run cargo doc --package sdl3 --open
Not all SDL3 extension libraries have full support in sdl3-rs yet.
| Library | |
|---|---|
| Dear ImGUI | ❌ Not currently supported |
| RmlUI | ❌ Not currently supported |
| SDL_gfx | 🟨 Waiting on improvements to the C library |
| SDL_image | ✅ Supported |
| SDL_mixer | ✅ Supported |
| SDL_sound | ❌ Not currently supported |
| SDL_ttf | ✅ Supported |
| SDL_net | ✅ Supported (enable the net feature) |
| SDL_shadercross | ❌ Not currently supported |
| sdl3-main | ✅ Supported |
We're looking for people to help get SDL3 support in Rust built, tested, and completed. You can help out!
Many examples and documentation requires updating. Interfaces have changed from SDL2 to SDL3, and the Rust bindings need to be updated to reflect these changes.
If you see anything wrong, missing, or suboptimal, please feel free to open a PR with your improvements.
If you would like to discuss ideas or ask questions, join the #rust channel on Discord.
This project was forked from Rust-sdl2 and the SDL2 code migrated to SDL3 according to the SDL2->SDL3 migration guide.
If you want a library compatible with earlier versions of SDL, please see Rust-sdl2.
