sdl2-mixerv2.8.2

Updated: 2026-05-12

Multi-channel audio mixer library for SDL.

Project website: https://github.com/libsdl-org/SDL_mixer

#Usage

sdl2-mixer provides CMake targets:

find_package(SDL2_mixer CONFIG REQUIRED)
target_link_libraries(main PRIVATE $<IF:$<TARGET_EXISTS:SDL2_mixer::SDL2_mixer>,SDL2_mixer::SDL2_mixer,SDL2_mixer::SDL2_mixer-static>)

#License

Zlib

zlib License

LICENSE.txt

#Supported Platforms

All platforms supported.

#Features

Default feature: wavpack

#fluidsynth

Use FluidSynth to play MIDI audio format.

Dependencies:

fluidsynth

and 2 transitive dependencies:

alsa (through fluidsynth)
Platforms: linux
gcem (through fluidsynth)

Host Dependencies:

4 transitive dependencies:

vcpkg-cmake (through vcpkg-cmake-get-vars)
vcpkg-cmake-config (through gcem)
vcpkg-cmake-get-vars (through vcpkg-make)
vcpkg-make (through alsa)

#libflac

Use libflac to play FLAC audio format.

Dependencies:

libflac

and one transitive dependency:

libogg (through libflac)

Host Dependencies:

2 transitive dependencies:

vcpkg-cmake (through libogg)
vcpkg-cmake-config (through libogg)

#libmodplug

Use libmodplug to play MOD audio format.

Dependencies:

No transitive dependencies.

Host Dependencies:

2 transitive dependencies:

vcpkg-cmake (through libmodplug)
vcpkg-cmake-config (through libxmp)

#mpg123

Use mpg123 to play MP3 audio format.

Dependencies:

mpg123

No transitive dependencies.

Host Dependencies:

3 transitive dependencies:

vcpkg-cmake (through mpg123)
vcpkg-cmake-config (through mpg123)
yasm (through mpg123)
Platforms: windows & !mingw
Features: tools

#opusfile

Use opusfile to play Opus audio format.

Dependencies:

opusfile

and 2 transitive dependencies:

libogg (through opusfile)
opus (through opusfile)

Host Dependencies:

2 transitive dependencies:

vcpkg-cmake (through libogg)
vcpkg-cmake-config (through libogg)

#timidity

Use Timidity to play MIDI audio format.

Dependencies:

No dependencies.

Host Dependencies:

No dependencies.

#wavpackdefault

Enable WavPack music.

Dependencies:

wavpack

No transitive dependencies.

Host Dependencies:

2 transitive dependencies:

vcpkg-cmake (through wavpack)
vcpkg-cmake-config (through wavpack)

#Dependencies

libvorbis
sdl2
Features: (none)

and one transitive dependency:

libogg (through libvorbis)

#Host Dependencies

No transitive dependencies.

#Used By

sdl2pp (feature sdl2-mixer)

#Host Tool For

No ports use this.

#Contributors

codicodi
Alexander Karatarakis
Robert Schumacher
Stephen E. Baker
Stanislav Ershov
Ryan Cheung
JackBister
Daniel
Helco
Antonio Maiorano
pravic
Jack·Boos·Yu
Stefano Sinigardi
Lily
JackBoosY
Jonathan Giannuzzi
Kevin Lu
Rémy Tassoux
NancyLi1013
JackMacWindows
autoantwort
Lily Wang
Oleg Derevenetz
Thomas1664
vividos
Pierre Wendling
jim wang
JonLiu1993
Kadir

#Changelog

4692d74
4692d74[sdl2-mixer] Update to version 2.8.2 (#51677)
2026-05-12
b61e514
b61e514[sdl2-mixer] Fix pc file on *-windows-static (#46828)
2025-08-12
7272b4b
7272b4b[sdl2-mixer] Add feature to use Timidity MIDI backend (#45141)
2025-04-22
4deb416
4deb416[sdl2-mixer] update to 2.8.1 (#43706)
2025-02-10
ea90335
ea90335[sdl2-mixer] Make wavpack a feature (#36982)
2024-03-19
cf4ebef
cf4ebef[sdl2-mixer| sdl2-image| sdl2-ttf] fix pc file in debug pkgconfig (#37411)
2024-03-15
b28ee3c
b28ee3c[sdl2-mixer] Fix feature libmodplug build failure (#36664)
2024-02-08
38fdc01
38fdc01[sdl2-mixer] Update to 2.8.0 and add dependency wavpack (#36629)
2024-02-07
2a6371b
2a6371b[sdl2,sdl2-*] allow disabling transitive dependencies (#35394)
2023-12-08
812080c
812080c[sdl2-mixer] Update features and fix static linking (#29681)
2023-03-21

Show 34 earlier changes

785cbdb
785cbdb[sdl2-mixer] Bump to 2.6.3 (#29487)
2023-02-10
f0a322f
f0a322f[sdl2-mixer] don't build samples (#27182)
2022-10-12
59b861a
59b861a[sdl2-mixer] Fix usage (#26083)
2022-08-04
359dbe3
359dbe3[sdl2-mixer] Update to 2.6.1 (#25763)
2022-07-18
50fd3d9
50fd3d9[sdl2-mixer] Fix link mpg123 error (#22049)
2021-12-17
86fb7a1
86fb7a1[sdl2-mixer] Fix feature mpg123 build error (#21812)
2021-12-06
7c92c79
7c92c79[sdl2pp] no absolute paths (#21722)
2021-11-30
9a23c09
9a23c09[sdl2-mixer] Fix link error building with features fluidsynth and libvorbis (#20089)
2021-09-13
92340aa
92340aa[sdl2-mixer] Add fluidsynth feature (#18826)
2021-07-06
1f7d384
1f7d384[sdl2-mixer] Fix features link error (#16737)
2021-03-18
0a262e7
0a262e7[sdl2] Update to 2.0.14 (#15398)
2021-01-05
62d4320
62d4320[sdl2-mixer] Fix FLAC symbol export when static linking, add nativemidi default feature (#12374)
2020-07-31
0babb75
0babb75[sdl2-mixer] Enable native MIDI support on macOS (#10201)
2020-02-28
53f1ae8
53f1ae8[sdl2-mixer] Fix dynamic loading when building static library (#9332)
2020-01-27
df484b0
df484b0[sdl2-mixer]Use dynamic library suffix when building dynamic library.
2019-10-08
df09093
df09093[sdl2-mixer]Delete the absolute path of the dependent libraries.
2019-10-08
808a19c
808a19c[sdl2-mixer]Re-fix dynamic call. (#8335)
2019-09-25
02881e6
02881e6[sdl2-mixer] Fix features dependency link. (#8208)
2019-09-23
63f1f07
63f1f07[sdl2-mixer]Remove useless dependency link libraries. (#7720)
2019-09-11
47d206e
47d206e[many ports] improvements for linux/wsl (#6730)
2019-06-20
0b24f31
0b24f31[sdl2-mixer]Fix build error with feature opusfile. (#6929)
2019-06-17
18b029a
18b029a[WIP] Add a Homepage URL entry for vcpkg ports (#2933)
2019-06-15
df753fb
df753fbFix sdl2-gfx, sdl2-image, sdl2-mixer, sdl2-net, and sdl2-ttf forcing debug lib first (SDL2d) (#5948)
2019-05-01
95785e1
95785e1[SDL2_xxx]: Add CMake targets for SDL2 addons (#5754)
2019-03-26
7dcf301
7dcf301Update various SDL2-based libraries (#5623)
2019-03-11
41a9614
41a9614Move SDL2_mixer optional dependencies to features (#5565)
2019-03-06
b316f9e
b316f9e[sdl2-mixer] Fixes for installing on Linux (#5366)
2019-02-16
7ad1fcc
7ad1fccPackage sdl2pp (#3430)
2018-05-18
2ad118a
2ad118aAdd missing version.rc file to sdl2 libraries.
2018-01-09
0526ec7
0526ec7[sdl2-mixer] Bump to 2.0.2
2017-11-13
deee8c1
deee8c1[sdl2-gfx][sdl2-image][sdl2-mixer][sdl2-net][sdl2-ttf] Fix accidental link of release libs in debug mode.
2017-10-19
26516fe
26516fevcpkg_configure_cmake (and _meson) now embed debug symbols within static libs (/Z7)
2017-09-09
dc4998b
dc4998b[sdl2] Prevent exports in static build
2017-07-21
722de28
722de28Add sdl2-mixer
2017-04-10

#Usage

#License

#Supported Platforms

#Features

#fluidsynth

#libflac

#libmodplug

#mpg123

#opusfile

#timidity

#wavpackdefault

#Dependencies

#Host Dependencies

#Used By

#Host Tool For

#Contributors

#Changelog

#Port Files