AudioCodecs collection

A collection of various audio codecs and their dependencies.

This is a set of dependencies required for SDL Mixer X audio library, except of SDL2 which is updating offten.

This set of libraries is designed to be buildable through CMake building system.

Note: to build libtimidity-sdl, you need to have the latest libSDL2 being installed, or enable the local SDL2 build. (This library was being modified to support files through SDL_RWops() API)

CI Badges

Operating system	Badge
Linux:
Windows:
macOS

How to build

Linux

You will need:

• CMake >= 3.2
• GCC and G++ >= 4.8
• libSDL2 library package installed, OR you can use -DUSE_LOCAL_SDL2=ON to use the vendored copy of SDL2 instead, or use the -DDOWNLOAD_SDL2_DEPENDENCY=ON CMake flag to automatically download from official GitHub repository using SDL2 branch and build this.

System install (will be installed with /usr/local/ prefix)

# Step 1: Download repository
git clone https://github.com/WohlSoft/AudioCodecs.git
cd AudioCodecs

# Step 2: PRepare build directory
mkdir build
cd build

# Step 3: Configure project (build a basic set of decoders)
cmake ..

# Step 4: Build
make
# Hint: to speed-up build use -j <num jobs> flag. Count of jobs should be equal number of CPU cores

# Step 5: Install
sudo make install

Custom install (You can install result into any folder and you don't need to have root to install)

# Step 1: Download repository
git clone https://github.com/WohlSoft/AudioCodecs.git
cd AudioCodecs

# Step 2: PRepare build directory
mkdir build
cd build

# Step 3: Configure project (build a basic set of decoders)
cmake -DUSE_LOCAL_SDL2=ON -DCMAKE_INSTALL_PREFIX=~/AudioCodecs/ ..

# Step 4: Build and install
cmake -build . -config release -target install -- -j 2
#   Tip: instead of "release" you can have "debug" to build debug versions. Instead of "2" put your actual count of CPU cores

macOS

The build for macOS is very similar to Linux way, you just can follow Linux way to build libraries.

If you want to use the system-wide SDL2 instead of local, you should install it via Homebrew or by any other way.

Windows

You will need:

• CMake >= 3.2
• MinGW >= 4.8, MinGW-w64 >= 5, or MSVC >=2015 (on your taste).
• The local or downloaded SDL2 will require the MinGW-w64 or MSVC instead of vanilla MinGW as current version is incompatible to the vanilla MinGW.

Build with MinGW

rem Step 1: Download repository
git clone https://github.com/WohlSoft/AudioCodecs.git
cd AudioCodecs

rem Step 2: PRepare build directory
mkdir build
cd build

rem Step 3: Configure project (build a basic set of decoders)
cmake -G "MinGW Makefiles" -DUSE_LOCAL_SDL2=ON -DCMAKE_INSTALL_PREFIX=%UserProfile%\MyLibs\ ..

rem Step 4: Build and install
cmake -build . -config release -target install -- -j 2
rem Tip: instead of "release" you can have "debug" to build debug versions. Instead of "2" put your actual count of CPU cores

Build with MinGW-w64 (A way to get 64-bit Windows assemblies)

rem Step 1: Download repository
git clone https://github.com/WohlSoft/AudioCodecs.git
cd AudioCodecs

rem Step 2: Prepare build directory
mkdir build
cd build
rem Important: You must to set the MinGW-w64 path first, also you must to remove a git from PATH if it is set
rem Full path may be different in dependence of version. Please fix this to match with your
set PATH=C:\mingw-w64\x86_64-6.3.0-posix-seh-rt_v5-rev1\mingw64\bin;%PATH:C:\Program Files\Git\usr\bin;=%

rem Step 3: Configure project
cmake -G "MinGW Makefiles" -DUSE_LOCAL_SDL2=ON -DCMAKE_INSTALL_PREFIX=%UserProfile%\MyLibs\ ..

rem Step 4: Build and install
cmake -build . -config release -target install -- -j 2
rem Tip: instead of "release" you can have "debug" to build debug versions. Instead of "2" put your actual count of CPU cores

Build with MSVC

rem Step 1: Download repository
git clone https://github.com/WohlSoft/AudioCodecs.git
cd AudioCodecs

rem Step 2: Prepare build directory
mkdir build
cd build

rem Step 3: Configure project
cmake -G "Visual Studio 14 2015" -DDOWNLOAD_SDL2_DEPENDENCY=ON -DCMAKE_INSTALL_PREFIX=%UserProfile%\MyLibs\ ..
rem HINT: If you want to have 64-bit build, use "Visual Studio 14 2015 Win64" generator
rem HINT: You can take full list of available generators by requesting of "cmake --help"

rem Step 4: Build and install
cmake -build . -config release -target install -- -j 2
rem Tip: instead of "release" you can have "debug" to build debug versions. Instead of "2" put your actual count of CPU cores

Licenses

• libADLMIDI: GNU LGPLv3+ or GNU GPLv3+
• libFLAC: Multiple: BSD 3-clause "New" or "Revised" License (libFLAC, libFLAC++), GNU GPL (extra plugins and tools)
• libFluidLite: GNU LGPLv2.1+
• libEDMIDI: ZLib license
• libGME: GNU LGPLv2.1+
• libModPlug: Public Domain
• libMPG123: GNU LGPLv2.1
• libMP3Lame: GNU LGPLv2+
• libOGG: BSD 3-clause "New" or "Revised" License
• libOpenMPT: BSD
• libOPNMIDI: GNU LGPLv3+ or GNU GPLv3+
• libOpus: BSD 3-clause "New" or "Revised" License
• libSDL2: ZLib
• libTimidity-SDL: The "Artistic License"
• libVorbis: BSD 3-clause "New" or "Revised" License
• libWavPack: BSD 3-clause "New" or "Revised" License
• libXMP: GNU LGPLv2+, partially MIT
• libZlib: ZLib license

Libraries are can be freely used in non-free projects:

Static linking

(BSD, ZLib, and "Artistic" licenses are allows usage in closed-source projects)

• libEDMIDI
• libFLAC
• libModPlug
• libOGG
• libOpenMPT
• libOpus
• libSDL2
• libTimidity-SDL
• libVorbis
• libWavPack
• libZlib

Dynamic linking

(LGPL allows usage in closed-source projects when LGPL-licensed components are linked dynamically)

• libEDMIDI
• libFLAC
• libFluidLite
• libGME
• libModPlug
• libMPG123
• libMP3Lame
• libOGG
• libOpenMPT
• libOpus
• libSDL2
• libTimidity
• libVorbis
• libWavPack
• libXMP
• libZlib

GPL-only projects

(These libraries has the viral GPL license and you can use these libraries in libre projects only with applying the GPL license to the whole project)

• libADLMIDI
• libOPNMIDI