# Announcing the sdl2-compat official release!

**URL:** <https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170>\
**Category:** SDL Announcements\
**Created:** [January 21, 2025, 10:09pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170 "2025-01-21T22:09:16Z")\
**Posts on this page:** 13\
**Page:** 1

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [January 21, 2025, 10:09pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/1 "2025-01-21T22:09:16Z")

</div>

Want the joy of SDL3 but are stuck using SDL2? … we’ve got you covered!

This code is a compatibility layer, providing a binary and source compatible API for programs written against SDL2, but it uses SDL3 behind the scenes.

Check it out at:

> **[Release 2.30.50 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.30.50)**
>
> Announcing the sdl2-compat official release!
> Want the joy of SDL3 but are stuck using SDL2? We've got you covered!
> This code is a compatibility layer, providing a binary and source compatible API f...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [January 29, 2025, 9:19pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/2 "2025-01-29T21:19:08Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.30.51 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.30.51)**
>
> This is a stable bugfix release, with the following changes:
> 
> Enable text input by default on desktop platform
> Enable render batching if a specific renderer hasn't been requested
> Fixed a memory leak

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [February 2, 2025, 1:41am UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/3 "2025-02-02T01:41:51Z")

</div>

Arch Linux replaced their SDL2 package with sdl2-compat and we got lots of great feedback!

> **[Release 2.30.52 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.30.52)**
>
> Arch Linux replaced their SDL2 package with sdl2-compat and we got lots of great feedback!
> Here is a quick update with the following improvements:
> 
> Fixed a black screen in some applications, includ...

This is a quick update with the following improvements:

- Fixed a black screen in some applications, including Source 1 games
- Fixed loud garbled audio in some applications, including Source 1 games and DOSBox
- Fixed audio crackling and potential related crashing in some applications, including vkQuake
- Fixed opening the main window in ffplay
- Fixed fullscreen window size when running some games like Meat Boy on Wayland with fractional scaling enabled
- Fixed keyboard input in Super Meat Boy
- Fixed mouse motion while the mouse is grabbed
- Fixed a crash in AntimicroX
- Fixed building applications that expect SDL to provide standard C headers
- Added support for the original Torchlight on Linux, which shipped using a pre-release SDL 2.0 library

If you were running into problems with sdl2-compat, please update to this release along with [SDL 3.2.2](https://github.com/libsdl-org/SDL/releases/tag/release-3.2.2) and let us know if you’re still having issues:

> **[libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/issues)**
>
> An SDL2 compatibility layer that uses SDL3 behind the scenes. - libsdl-org/sdl2-compat

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [February 7, 2025, 12:55am UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/4 "2025-02-07T00:55:10Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.30.54 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.30.54)**
>
> This is a stable bugfix release, with the following changes:
> 
> Fixed the mouse wheel in Torchlight
> Fixed double-free if SDL RLE encodes a surface during blit
> Fixed SDL\_ConvertSurface() returning NUL...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [March 2, 2025, 4:55am UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/5 "2025-03-02T04:55:42Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.52 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.52)**
>
> This is a stable bugfix release, with the following changes:
> 
> Fixed tiny scaled window in recent versions of Wesnoth
> Fixed a rare deadlock when opening an audio device using PipeWire on Linux
> Fixed...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [March 31, 2025, 9:29pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/6 "2025-03-31T21:29:21Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.54 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.54)**
>
> This is a stable bugfix release, with the following changes:
> 
> sdl2\_compat.pc was renamed to sdl2-compat.pc
> Fixed creating fullscreen exclusive windows
> Fixed relative mouse motion for Half-Life and ...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [May 4, 2025, 6:25pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/7 "2025-05-04T18:25:31Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.56 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.56)**
>
> This is a stable bugfix release, with the following changes:
> 
> Fixed rendering in Mesen2
> Fixed brightness in ioquake3
> Fixed a hang at launch in the xemu emulator
> Fixed crackling and sped up audio in...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [October 30, 2025, 5:41pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/8 "2025-10-30T17:41:24Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.58 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.58)**
>
> This is a stable bugfix release, with the following changes:
> 
> Fixed a crash at startup in Hearts of Iron IV
> Fixed mouse movement in Heroes of Might and Magic III
> Fixed crash under Wayland with Heav...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [December 2, 2025, 10:10pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/9 "2025-12-02T22:10:42Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.60 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.60)**
>
> This is a stable bugfix release, with the following changes:
> 
> Fixed crash at startup in Dwarf Fortress
> Fixed crash at startup in Stellaris
> Fixed mouse stuttering in Amiberry
> Fixed the viewport not ...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [January 1, 2026, 3:04am UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/10 "2026-01-01T03:04:57Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.62 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.62)**
>
> This is a stable bugfix release, with the following changes:
> 
> Improved support for GNU/Hurd
> Fixed crash if hidapi strings are not available

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [February 4, 2026, 5:57pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/11 "2026-02-04T17:57:33Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.64 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.64)**
>
> This is a stable bugfix release, with the following changes:
> 
> Fixed surface memory leak in some circumstances
> Fixed mouse grab not persisting past window recreation
> Fixed picking the correct fullsc...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [April 4, 2026, 12:37am UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/12 "2026-04-04T00:37:47Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.66 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.66)**
>
> This is a stable bugfix release, with the following changes:
> 
> Fixed video flicker in Domino-Chain
> Fixed window size being delivered to windows created in fullscreen mode
> Fixed double scaling when s...

---

<div class="post-metadata">

**Author:** ![slouken](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/s/ec9cab/32.png) [@slouken](https://discourse.libsdl.org/u/slouken)\
**Post date:** [May 1, 2026, 6:43pm UTC](https://discourse.libsdl.org/t/announcing-the-sdl2-compat-official-release/57170/13 "2026-05-01T18:43:35Z")

</div>

A minor update with bug fixes has been released:

> **[Release 2.32.68 · libsdl-org/sdl2-compat](https://github.com/libsdl-org/sdl2-compat/releases/tag/release-2.32.68)**
>
> This is a stable bugfix release, with the following changes:
> 
> Fixed gamepad rumble in Middle-earth: Shadow of Mordor and other games on Linux
> Added an "SDL3\_VERSION" hint that can be read by games ...