cmake | ||
example | ||
src | ||
test | ||
.gitignore | ||
CMakeLists.txt | ||
default.nix | ||
LICENSE | ||
README.md |
libsoundio
C library which provides cross-platform audio input and output. The API is suitable for real-time software such as digital audio workstations as well as consumer software such as music players.
This library is an abstraction; however it prioritizes performance and power over API convenience. Features that only exist in some sound backends are exposed.
This library is a work-in-progress.
How It Works
libsoundio tries these backends in order. If unable to connect to that backend, due to the backend not being installed, or the server not running, or the platform is wrong, the next backend is tried.
- JACK
- PulseAudio
- ALSA (Linux)
- CoreAudio (OSX)
- ASIO (Windows)
- DirectSound (Windows)
- OSS (BSD)
- Dummy
Contributing
libsoundio is programmed in a tiny subset of C++:
- No STL.
- No
new
ordelete
. - No
class
. All fields in structs arepublic
. - No exceptions or run-time type information.
- No references.
- No linking against libstdc++.
Building
$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install
Building With MXE
You can build libsoundio with mxe. Follow the requirements section to install the packages necessary on your system. Then somewhere on your file system:
$ git clone https://github.com/mxe/mxe
$ cd mxe
$ make gcc
Then in the libsoundio source directory (replace "/path/to/mxe" with the appropriate path):
$ mkdir build-win
$ cd build-win
$ cmake .. -DCMAKE_TOOLCHAIN_FILE=/path/to/mxe/usr/i686-w64-mingw32.static/share/cmake/mxe-conf.cmake
$ make
Roadmap
- ALSA (Linux)
- Avoid calling
panic
in PulseAudio. - JACK
- Dummy
- CoreAudio (OSX)
- ASIO (Windows)
- DirectSound (Windows)
- OSS (BSD)