libsndfile is a C library for reading and writing files containing sampled audio data.
The canonical source code repository for libsndfile is at https://github.com/erikd/libsndfile/.
You can grab the source code using:
$ git clone git://github.com/erikd/libsndfile.git
For building for Android see BuildingForAndroid.
There are currently two build systems; the official GNU autotool based one and a more limited and experimental CMake based build system. Use of the CMake build system is documented below.
Setting up a build environment for libsndfile on Debian or Ubuntu is as simple as:
sudo apt install autoconf autogen automake build-essential libasound2-dev \
libflac-dev libogg-dev libtool libvorbis-dev pkg-config python
For other Linux distributions or any of the *BSDs, the setup should be similar although the package install tools and package names may be slightly different.
Similarly on Mac OS X, assuming brew is already installed:
brew install autoconf autogen automake flac libogg libtool libvorbis pkg-config
Once the build environment has been set up, building and testing libsndfile is as simple as:
$ ./autogen.sh
$ ./configure --enable-werror
$ make
$ make check
The CMake build system is still experimental and probably only works on linux because it still relies on GNU autotools for bootstrapping. Using it as simple as:
$ Scripts/cmake-build.sh
I would be happy to accept patches to make the CMake build system more portable.
- Patches should pass all pre-commit hook tests.
- Patches should always be submitted via a either Github "pull request" or a via emailed patches created using "git format-patch".
- Patches for new features should include tests and documentation.
- Patches to fix bugs should either pass all tests, or modify the tests in some sane way.
- When a new feature is added for a particular file format and that feature makes sense for other formats, then it should also be implemented for one or two of the other formats.