libgsf is a library for reading and playing GSF (GBA Sound File) and MiniGSF files. At the time of writing, it supports only the very simple stuff:

• Reading files
• Playing samples
• Seeking
• Reading tags and other info

Note that the library is currently in beta. While it's already usable, you may find that by upgrading some stuff might break.

You can either compile and install it manually, or add this repository inside your project and use CMake's add_subdirectory to get it compiled automatically.

Required dependencies are zlib and mgba. You can install zlib through your package manager, while mgba is included inside the repo.

For starters, clone this repository with

git clone --recursive https://github.com/chrg127/libgsf

Compiling is done through CMake. Use the following commands to build:

mkdir build
cd build
cmake .. -DBUILD_EXAMPLES=ON -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release

This will build both the library and the two examples provided inside the directory build. You can then install through this command:

cmake --install . --config Release --prefix /path/to/installation

On Windows, life is more complicated. The recommended way is using conan (only used to install zlib (and SDL for the examples)). Issue the following commands:

conan install . --output-folder=build --build=missing
cd build
cmake .. -DBUILD_EXAMPLES=ON -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake
cmake --build . --config Release

For installing, it's the same as above.