This is the first release candidate for the official SDL_mixer 3.0 release!

SDL_mixer 3.0 is a complete redesign, rewritten almost from scratch to address deficiencies in SDL_mixer 2.0. The API is completely different and, in our opinion, a significant improvement in power and ease of use. Please refer to README-migration.md for details on how to migrate your program to the new API.

You can see an example of how to use the new API here:
https://github.com/libsdl-org/SDL_mixer/blob/main/docs/hello.c

Please let us know if you run into any issues!

This is a stable bugfix release, with the following changes:

• Added Stop/Start/Pause/Resume for Fluidsynth

In addition to lots of bug fixes, here are the major changes in this release:

• Added support for loading wavpack sound files (https://www.wavpack.com/)
• Added support for loading classic console sound files using Game_Music_Emu (https://github.com/libgme/game-music-emu)
• Use minimp3 instead of dr_mp3 as the default backend for MP3 music
• Use libxmp instead of modplug as the default backend for MOD music
  To use libmodplug instead, configure using --enable-music-mod-modplug --disable-music-mod-xmp
• Added support for FLAC audio in Ogg containers
• Added Mix_PauseAudio() to pause and resume all audio playback
• Added Mix_GetNumTracks() and Mix_StartTrack() for managing tracks in GME files

This is a release candidate for 2.8.0.

In addition to lots of bug fixes, here are the major changes in this release:

• Added support for loading wavpack sound files (https://www.wavpack.com/)
• Added support for loading classic console sound files using Game_Music_Emu (https://github.com/libgme/game-music-emu)
• Use minimp3 instead of dr_mp3 as the default backend for MP3 music
• Use libxmp instead of modplug as the default backend for MOD music
  To use libmodplug instead, configure using --enable-music-mod-modplug --disable-music-mod-xmp
• Added support for FLAC audio in Ogg containers
• Added Mix_PauseAudio() to pause and resume all audio playback
• Added Mix_GetNumTracks() and Mix_StartTrack() for managing tracks in GME files

This is a stable bugfix release, with the following changes:

• Fixed tags memory leak in Opus music

This is a quick update to fix building with homebrew on macOS

This is a minor bug-fix release, fixing a packaging issue on Linux.

Here are the highlights for the 2.6.0 release:

• API documentation is now available on the wiki: https://wiki.libsdl.org/SDL_mixer
• Added support for building with CMake
• Added support for playing Ogg files using stb_vorbis, which is now the default Vorbis backend.
  To use libvorbis instead, configure using --disable-music-ogg-stb --enable-music-ogg-vorbis
• Added support for playing FLAC files using dr_flac, which is now the default FLAC music backend.
  To use libflac instead, configure using --disable-music-flac-drflac --enable-music-flac-libflac
• Added support for playing MP3 files using dr_mp3, which is now the default MP3 music backend.
  To use libmpg123 instead, configure using --disable-music-mp3-drmp3 --enable-music-mp3-mpg123
• Added libxmp support for mod music playback. Modplug is still the default backend for MOD music.
  To use libxmp instead, configure using --disable-music-mod-modplug --enable-music-mod-xmp
• Removed support for libmad as a MP3 music backend.
• Removed support for libmikmod as a MOD music backend.
• Added Mix_MasterVolume() for additional volume control over all channels
• Update Mix_Init() return value to match documentation, including MIXER_INIT_* flags for already-initialized modules
• Added Mix_HasMusicDecoder()
• Memory leak fixes and F32 format support to fluidsynth player
• Fixed distorted MIDI playback with FluidSynth if sample rate is out of library's limits
• Added Mix_ModMusicJumpToOrder() for mod music formats
• Enabled module internal loops in modplug player
• Respect original mp3 file offset
• Support setting soundfont via SDL_SOUNDFONTS in OSX native midi
• Fixed mp3 file detection
• Fixes to ogg playback on big-endian devices
• Added functions to get metadata information:
  Mix_GetMusicTitle()
  Mix_GetMusicTitleTag()
  Mix_GetMusicArtistTag()
  Mix_GetMusicAlbumTag()
  Mix_GetMusicCopyrightTag()
• Add functions to get loop point information:
  Mix_GetMusicLoopStartTime()
  Mix_GetMusicLoopEndTime()
  Mix_GetMusicLoopLengthTime()
• Added Mix_GetMusicVolume() and Mix_GetMusicPosition()
• Added Mix_MusicDuration() to return music duration in seconds
• Fixed music_mpg123 seek bug when sample rate of the file and the stream don't match
• Timidity improvements, added Mix_SetTimidityCfg()
• Improved mp3 tag detection/skipping
• Extended support for WAV files
• Allow rmid files be opened by native midi
• Fixed possible crash in win32 native midi
• Prevent clipping due to volume settings in modplug music
• Added looping support for Opus files
• Added looping support for FLAC files
• Improved OGG looping support
• Fixed loading Opus audio as audio chunks

In addition to new CMake support by @madebr and many bug fixes, here are the highlights since the last release:

• API documentation is now available on the wiki: https://wiki.libsdl.org/SDL_mixer
• Added support for building with CMake
• Added support for playing Ogg files using stb_vorbis, which is now the default Vorbis backend.
  To use libvorbis instead, configure using --disable-music-ogg-stb --enable-music-ogg-vorbis
• Added support for playing FLAC files using dr_flac, which is now the default FLAC music backend.
  To use libflac instead, configure using --disable-music-flac-drflac --enable-music-flac-libflac
• Added support for playing MP3 files using dr_mp3, which is now the default MP3 music backend.
  To use libmpg123 instead, configure using --disable-music-mp3-drmp3 --enable-music-mp3-mpg123
• Added libxmp support for mod music playback. Modplug is still the default backend for MOD music.
  To use libxmp instead, configure using --disable-music-mod-modplug --enable-music-mod-xmp
• Removed support for libmad as a MP3 music backend.
• Removed support for libmikmod as a MOD music backend.
• Added Mix_MasterVolume() for additional volume control over all channels
• Update Mix_Init() return value to match documentation, including MIXER_INIT_* flags for already-initialized modules
• Added Mix_HasMusicDecoder()
• Memory leak fixes and F32 format support to fluidsynth player
• Fixed distorted MIDI playback with FluidSynth if sample rate is out of library's limits
• Added Mix_ModMusicJumpToOrder() for mod music formats
• Enabled module internal loops in modplug player
• Respect original mp3 file offset
• Support setting soundfont via SDL_SOUNDFONTS in OSX native midi
• Fixed mp3 file detection
• Fixes to ogg playback on big-endian devices
• Added functions to get metadata information:
  Mix_GetMusicTitle()
  Mix_GetMusicTitleTag()
  Mix_GetMusicArtistTag()
  Mix_GetMusicAlbumTag()
  Mix_GetMusicCopyrightTag()
• Add functions to get loop point information:
  Mix_GetMusicLoopStartTime()
  Mix_GetMusicLoopEndTime()
  Mix_GetMusicLoopLengthTime()
• Added Mix_GetMusicVolume() and Mix_GetMusicPosition()
• Added Mix_MusicDuration() to return music duration in seconds
• Fixed music_mpg123 seek bug when sample rate of the file and the stream don't match
• Timidity improvements, added Mix_SetTimidityCfg()
• Improved mp3 tag detection/skipping
• Extended support for WAV files
• Allow rmid files be opened by native midi
• Fixed possible crash in win32 native midi
• Prevent clipping due to volume settings in modplug music
• Added looping support for Opus files
• Added looping support for FLAC files
• Improved OGG looping support
• Fixed loading Opus audio as audio chunks

This is hopefully the final release candidate for 2.6.0.

The header documentation has been updated and is available at https://wiki.libsdl.org/SDL_mixer

This is a release candidate for 2.6.0.

In addition to new CMake support by @madebr and many bug fixes, here are the highlights since the last release:

• Added support for playing Ogg files using stb_vorbis, which is now the default Vorbis backend.
  To use libvorbis instead, configure using --disable-music-ogg-stb --enable-music-ogg-vorbis
• Added support for playing FLAC files using dr_flac, which is now the default FLAC music backend.
  To use libflac instead, configure using --disable-music-flac-drflac --enable-music-flac-libflac
• Added support for playing MP3 files using dr_mp3, which is now the default MP3 music backend.
  To use libmpg123 instead, configure using --disable-music-mp3-drmp3 --enable-music-mp3-mpg123
• Added libxmp support for mod music playback. Modplug is still the default backend for MOD music.
  To use libxmp instead, configure using --disable-music-mod-modplug --enable-music-mod-xmp
• Removed support for libmad as a MP3 music backend.
• Removed support for libmikmod as a MOD music backend.
• Added Mix_MasterVolume() for additional volume control over all channels
• Update Mix_Init() return value to match documentation, including MIXER_INIT_* flags for already-initialized modules
• Added Mix_HasMusicDecoder()
• Memory leak fixes and F32 format support to fluidsynth player
• Fixed distorted MIDI playback with FluidSynth if sample rate is out of library's limits
• Added Mix_ModMusicJumpToOrder() for mod music formats
• Enabled module internal loops in modplug player
• Respect original mp3 file offset
• Support setting soundfont via SDL_SOUNDFONTS in OSX native midi
• Fixed mp3 file detection
• Fixes to ogg playback on big-endian devices
• Added functions to get metadata information:
  Mix_GetMusicTitle()
  Mix_GetMusicTitleTag()
  Mix_GetMusicArtistTag()
  Mix_GetMusicAlbumTag()
  Mix_GetMusicCopyrightTag()
• Add functions to get loop point information:
  Mix_GetMusicLoopStartTime()
  Mix_GetMusicLoopEndTime()
  Mix_GetMusicLoopLengthTime()
• Added Mix_GetMusicVolume() and Mix_GetMusicPosition()
• Added Mix_MusicDuration() to return music duration in seconds
• Fixed music_mpg123 seek bug when sample rate of the file and the stream don't match
• Timidity improvements, added Mix_SetTimidityCfg()
• Improved mp3 tag detection/skipping
• Extended support for WAV files
• Allow rmid files be opened by native midi
• Fixed possible crash in win32 native midi
• Prevent clipping due to volume settings in modplug music
• Added looping support for Opus files
• Added looping support for FLAC files
• Improved OGG looping support
• Fixed loading Opus audio as audio chunks