NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #4949 most downloaded on crates.io
Raw SDL2 bindings for Rust, used internally rust-sdl2
Latest stable
0.38.0
Last release 1 years ago
12 Jul 2025
Release timing varies
gaps range from 3 weeks to 1.8 years
Some releases are documented
notes for 17 of 58 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
59 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
PR #1473 BREAKING CHANGE Fix UB in ToColor implementations and remove implementation for isize.
PR #1493 Add Rect::origin and specifies origin location in Rect::new.
PR #1472 Add Canvas::render_geometry, Canvas::render_geometry_raw and an example that uses them both. Both these bindings use SDL_RenderGeometryRaw.
PR #1473 BREAKING CHANGE Fix UB in ToColor implementations and remove implementation for isize.
PR #1414 Use TTF_GlyphIsProvided32 and TTF_GlyphMetrics32 instead of the 16 bit ones.
PR #1435 BREAKING CHANGE Fix some undefined behavior. Breaking changes: mixer::Chunk's fields are now private and callbacks to TimerSubsystem::add_timer must now live for 'static, also allowing some lifetime parameters to be removed.
PR #1461 BREAKING CHANGE Added new SensorType variants: LeftGyroscope, RightGyroscope, LeftAccelerometer, RightAccelerometer
PR #1461 BREAKING CHANGE Sensor::get_data now returns correct SensorData::Gyro enum
PR #1437 BREAKING CHANGE Prevent users from creating Sdl2TtfContext out of nothing and use SDL's reference counting init/quit
PR #1464 Added binding for Mix_OpenAudioDevice
PR #1451 Add gamma_ramp_arrays and calculate_gamma_ramp.
PR #1459 BREAKING CHANGE Fix image and mixer init flag logic. image::init and mixer::init will now return an error if any of the requested formats can not be initialized.
PR #1444 Add texture scale mode api + fix unsafe
PR #1415 Store gfx::framerate::FPSmanager directly in FPSManager instead of on the heap.
PR #1450 BREAKING CHANGE Create ClippingRect type, to disambiguate between no and zero area clipping rect.
PR #1416 Apply clippy fixes, fix deprecations and other code quality improvements.
PR #1408 Allow comparing Versions, add constant with the version the bindings were compiled with.
PR #1407 Add new use_ios_framework for linking to SDL2.framework on iOS
PR #1427 BREAKING CHANGE Add system locale support. A new event type Event::LocaleChanged has been added.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
PR #1378 BREAKING CHANGE Change Keycode to be a struct rather than an enum. Fix Keycode::from_scancode for non-QWERTY keyboard layouts.
PR #1406 Update bindings to SDL 2.0.26, add Event.is_touch() for mouse events, upgrade wgpu to 0.20 in examples
PR #1398 Fix bug in rect.shift logic
PR #1404 Make SdlDrop a zero sized type.
PR #1394 Do not pull the SDL repository if not using bundled in build.rs
PR #1394 Fix static linking
PR #1389 Fix some undefined behavior.
PR #1378 BREAKING CHANGE Change Keycode to be a struct rather than an enum. Fix Keycode::from_scancode for non-QWERTY keyboard layouts.
PR #1390 Apply clippy fixes, fix deprecations and other code quality improvements.
PR #1385 Upgrade raw-window-handle to 0.6.0
PR #1380 Add controller vendor_id() and product_id()
PR #1368 Remove unnecessary unsafe in Window interface. Make Window Clone.
PR #1366 Add Primary Selection bindings.
PR #1270 BREAKING CHANGE Remove &mut self requirement in TimerSubsystem::delay; Add TimerSubsystem::ticks64
PR #1270 BREAKING CHANGE Remove &mut self requirement in TimerSubsystem::delay; Add TimerSubsystem::ticks64
PR #1275 BREAKING CHANGE Update raw-window-handle to 0.5
PR #1225 Update wgpu to 0.12 in examples
PR #1250 Add lib64 to native library search path when using bundled feature
PR #1240 BREAKING CHANGE Take PixelMasks by reference
PR #1254 BREAKING CHANGE Make SdlDrop and SubsystemDrop safer; forbid external code from constructing SdlDrop
PR #1318 Add NV12, NV21 to PixelFormatEnum
PR #1332 Fix size_hint implementations for {audio,video,render}::DriverIterator
PR #1333 Implement FusedIterator, DoubleEndedIterator, and nth[_back] for {audio,video,render}::DriverIterator
PR #1337 Fix "Cannot initialize Sdl from more than one thread" for tests / CI
PR #1346 Add basic Shaped Window support
PR #1314 Add "ALWAYS ON TOP" support for X11
PR #1189 Added AudioQueue::queue_audio and deprecated AudioQueue::queue
PR #1173 Fix segfault when using timer callbacks
PR #1183 WinRT support for raw-window-handle
PR #1182 Updated raw-window-handle to 0.4
PR #1189 Added AudioQueue::queue_audio and deprecated AudioQueue::queue
PR #1164 Added raw-window-handle support for Android
PR #1165 Added binding for SDL_GetDisplayOrientation and SDL_DISPLAYEVENT
Nothing published for this version
BREAKING CHANGE Update sdl2-sys/sdl_bindings.rs to use enums instead of consts. If you were using sdl2-sys's enum variants directly in your project, y…
BREAKING CHANGE Update sdl2-sys/sdl_bindings.rs to use enums instead of consts. If you were using sdl2-sys's
enum variants directly in your project, you may be affected. If you only used sdl2 calls, there should not be any problems.
BREAKING CHANGE SDL 2.0.14 or higher is now recommended due to the new binding being added for SDL_OpenURL. If you get linking errors, upgrade your SDL2 libraries, or swap to using the bundled feature.
PR #1138 Added binding for SDL_OpenURL
PR #1150 Do not download SDL2 sources when using bundled feature
PR #1112 Add wrapper functions for SDL_RenderSetIntegerScale and SDL_RenderGetIntegerScale
PR #1156 Maybe breaking change: new variants to enum GameController, and prevent panic with unrecognized buttons.
PR #1153 SDL_GL_GetCurrentContext and SDL_RenderFlush added.
PR #1131 Added Sensor API.
PR #1100 Added binding for SDL_GetDisplayUsableBounds
PR #1100 Added binding for SDL_GetDisplayUsableBounds
PR #1102 Correctly se linux and macSO built libraries when using bundled without static-link.
PR #1098 Fix potential heap corruption when using AudioCVT::convert
PR #1088 Rollback of PR #1081: Broke dynamic linking on Windows
Various fixes to CI.
PR #1086 Update bundled to use SDL2 2.0.14
PR #1086 Update bundled to use SDL2 2.0.14
PR #1033 Changed signature of TimerSubsystem::ticks to accept &self.
PR #1057: fix memory safety bug in set_error
PR #1081: Allow bundled build to be built in debug mode. Fixes issue when linking binary with mixed debug+release CRT dependencies.
PR #1080: Fix line endings of patches to lf so patching of sources works on Windows.
PR #1031: Add patch to fix metal detection (https://bugzilla.libsdl.org/show_bug.cgi?id=4988)
PR #1027: upgrade "bundled" version of SDL2 to 2.0.12 PR #1020: revert undefined behavior introduction. Commit: Fix clippy issue Commit: Temporarily s
PR #1012 Fix use after free with AudioDevice::open and AudioDevice::open\_queue
PR #964: Breaking change: Change joystick instance IDs from i32 to u32.
PR #962:
Added raw-window-handle support for Windows, Linux (X11 and Wayland) and macOS.
PR #964: Breaking change: Change joystick instance IDs from i32 to u32.
PR #965: Added invert method for Color, and added more Color names as constants.
PR #968
Pass SDL2 include directories to sdl2-sys's dependant crates through DEP_SDL2_INCLUDE.
PR #970
Add Chunk::from_buffer in mixer.
PR #976
Fix compilation with use-bingen feature.
PR #977
Add cpuinfo::has_avx2 and cpuinfo::has_avx512f
PR #982 Support for loading Opus format in mixer.
PR #980 Fix compilation on Windows.
PR #940: Breaking change Removed the rand dependency for random colors. You will have to implement your own random colors from now on.
PR #956 + PR #960 + PR #951: Fix some build targets.
PR #948 + PR #957:
Remove the num dependency.
PR #947: Upgraded the "bundled" version of SDL2 to 2.0.10
PR #940:
Breaking change Removed the rand dependency for random colors. You will have to implement your own random colors from now on.
PR #933: Breaking change Removed AudioFormatNum::zero(), use AudioFormatNum::SILENCE constant instead.
PR #907:
Changed the data type to i32 for the which field for the events ControllerDeviceAdded and JoyDeviceAdded.
PR #882:
Ignore unknown bits in SDL_Keysym's mod field (key modifiers) when constructing Event::KeyDown and Event::KeyUp. Deprecate sdl2::event::Event::unwrap_keymod, which had been made public accidentally.
PR #898:
Implements TryFrom<PixelFormatEnum> for PixelFormat
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
PR #868: Added inplace operations for rect::Point.
PR #868:
Added inplace operations for rect::Point.
PR #827: Added 32-bit array pixelformats
PR #824:
Added controller::set_rumble and joystick::set_rumble, wrappers for SDL_GameControllerRumble and SDL_JoystickRumble respectively.
PR #867:
Added Window::opacity and Window::set_opacity, wrappers for SDL_GetWindowOpacity and SDL_SetWindowOpacity respectively. This bumps the minimum SDL2 version requirement from 2.0.4 to 2.0.5.
Nothing published for this version
PR #751: Breaking change gl_setswap_interval now returns a Result instead of a bool.
PR #790: Added missing window_id field to Event::DropFile
PR #789: Audio Safety Fixes
PR #785: Vulkan Support
sysPR #780: Fixed a panic in keyboard::Mod
PR #775: Added get_platform
PR #774: add_timer is now must_use
PR #764: impl Hash for Point and Rect
PR #763: Allow -sys to build for windows-gnu target
PR #751:
Breaking change gl_setswap_interval now returns a Result instead of a bool.
PR #759: Expose Joystick power level
filesystem::base_path()ClipboardUtil::clipboard_text()PR #740: Implement Debug for Event
PR #737:
Fix ClipboardUtil::set_clipboard_text to return an Ok when it went well.
PR #733:
Add video::border_size -> Result<(u16, u16, u16, u16), String> equivalent of SDL_GetWindowBorderSize()
PR #732:
Implemented From<(u8, u8, u8)> and From<(u8, u8, u8, u8)> for pixels::Color.
Canvas.set_draw_color can now be called with tuples or other types which implements Into<pixels::Color>
Breaking change Change HatState::Leftdown casing into HatState::LeftDown to be consistent with naming.
unsafe_textures feature to this crate, allowing to get rid of the lifetimes
in Textures in the render module.Music::from_static_bytes function, which creates a Music instance with the
static lifetime from a buffer that also has a static lifetime.sdl2::mixer::Channel(i32) and sdl::mixer::Group(i32) structs
public so they can be instantiated directly, and deprecates sdl2::mixer::channel(i32).which fields of sdl2::Event::ControllerDeviceAdded and sdl2::Event::JoyDeviceAdded to be u32s so they can be used with sdl2::GameControllerSubsystem and sdl::JoystickSubsystem methods directly.sdl2::HapticSubsystem::open_from_joystick_id to correctly advertise joystick_index as being a u32.…for soundness and safety! This change is a breaking change, and a huge one at that.
Re-exported sdl2_sys as sdl2::sys
The path of soundness isn't an easy one; sometimes ease of use has to be sacrificed for soundness and safety! This change is a breaking change, and a huge one at that.
You will probably have to refactor some parts of your code, but this is the price to pay for soundness and runtime safety.
Breaking Changes:
Renderer has been renamed and split into Canvas and TextureCreator.Canvas can store a Surface or a Window, and can be used to render into these as well.
TextureCreator creates Textures and is used by Texture to make sure they don't live
longer than expected.set_render_target has been removed and has been replaced with Canvas::with_texture_canvas
and Canvas::with_multiple_texture_canvasWindowRef, it wasn't useful anymore.Other Changes:
PixelFormatEnum::supports_alpha(&self) -> bool method.Canvas
and TextureCreator structs, as well as adding a very basic game to show how to handle input / game
changes in a basic game.You won't have to worry about what target your Renderer has at runtime anymore, everything
is done at compile time now !
Surface::fill_rects (old | new)Option<T> parameters into Into<Option<T>> parameters. For instance, it is now possible to do this:surface.blit(None,Rect::new(5,5,5,5)); // instead of surface.blit(None,Some(Rect::new(5,5,5,5)));
sdl2::hintsdl2::hint::set_video_minimize_on_focus_lost(bool) -> bool;
sdl2::hint::set_video_minimize_on_focus_lost_with_priority(bool, sdl2::hint::Hint) -> bool;
sdl2::hint::get_video_minimize_on_focus_lost() -> bool;
let color = Color { r: 255, g: 0, b: 0, a: 255 };
let color = Color::RGBA(255, 0, 0, 255);
let color = Color::RGB(255, 0, 0);
let (r, g, b) = color.rgb();
let (r, g, b, a) = color.rgba();
Result<String, String> instead of a String.window.surface() has been changed and is now more intuitive to use.examples/no-renderer.rs shows how to use this feature.Rect::contains, added Rect::contains_point and Rect::contains_rect. contains and contains_point are close but different ! See hereNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Updated version in README
Updated version in README
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Version 0.1.0 - Compatible with Rust beta
Version 0.1.0 - Compatible with Rust beta
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.