OpenAL Soft is a software implementation of the OpenAL 3D audio API.
C CMake C++
Permalink
Failed to load latest commit information.
Alc Use second-order biquad filters for the reverb's T60 decay Aug 13, 2018
OpenAL32 EFX: Autowah implementation Jul 25, 2018
build Move the default out-of-tree build dir to build Sep 13, 2009
cmake Don't cache SDL2_LIBRARY_TEMP with CMake Mar 30, 2018
common Clear the TLS pointer after running its destructor callback Jun 7, 2018
docs Fix misspellings of quadraphonic Mar 30, 2018
examples Add an alffplay option to play stereo streams with wide angles May 17, 2018
hrtf Update default HRTFs for 24-bit samples Oct 22, 2017
include/AL Add simple descriptions to some extension formats in alext.h Mar 30, 2018
native-tools Use a -40dB drop for bsinc12 Jan 7, 2018
presets Fix misspellings of quadraphonic Mar 30, 2018
router Avoid duplicate path searches in the router Mar 22, 2018
utils Alsoft-config: Add autowah effect Jul 25, 2018
.gitignore Update .gitignore Apr 14, 2018
.travis.yml Use the right path for android's cmake toolchain Dec 16, 2017
CMakeLists.txt EFX: Autowah implementation Jul 25, 2018
COPYING Fix COPYING Jul 3, 2018
ChangeLog Update ChangeLog Jul 28, 2018
README.md Additional corrections as mentionned in the PR Jan 28, 2018
XCompile-Android.txt Add a toolchain for Android cross-compiling Nov 11, 2014
XCompile.txt Update cross-compiler toolchain to work better with Qt Nov 7, 2014
alsoftrc.sample Alsoft-config: Add autowah effect Jul 25, 2018
appveyor.yml Rename the mmdevapi backend to wasapi Mar 10, 2018
config.h.in Use proc_pidpath to get the process path on macOS when available Mar 24, 2018
openal.pc.in Specify Libs.private for the pkg-config file Mar 30, 2018
version.cmake More robustly generate the git commit ID and branch Dec 21, 2016
version.h.in Trace the commit ID and branch the library was built from Dec 21, 2016

README.md

OpenAL soft

master branch CI status : Build Status Windows Build Status

OpenAL Soft is an LGPL-licensed, cross-platform, software implementation of the OpenAL 3D audio API. It's forked from the open-sourced Windows version available originally from openal.org's SVN repository (now defunct). OpenAL provides capabilities for playing audio in a virtual 3D environment. Distance attenuation, doppler shift, and directional sound emitters are among the features handled by the API. More advanced effects, including air absorption, occlusion, and environmental reverb, are available through the EFX extension. It also facilitates streaming audio, multi-channel buffers, and audio capture.

More information is available on the official website

Source Install

To install OpenAL Soft, use your favorite shell to go into the build/ directory, and run:

cmake ..

Assuming configuration went well, you can then build it, typically using GNU Make (KDevelop, MSVC, and others are possible depending on your system setup and CMake configuration).

Please Note: Double check that the appropriate backends were detected. Often, complaints of no sound, crashing, and missing devices can be solved by making sure the correct backends are being used. CMake's output will identify which backends were enabled.

For most systems, you will likely want to make sure ALSA, OSS, and PulseAudio were detected (if your target system uses them). For Windows, make sure DirectSound was detected.

Utilities

The source package comes with an informational utility, openal-info, and is built by default. It prints out information provided by the ALC and AL sub- systems, including discovered devices, version information, and extensions.

Configuration

OpenAL Soft can be configured on a per-user and per-system basis. This allows users and sysadmins to control information provided to applications, as well as application-agnostic behavior of the library. See alsoftrc.sample for available settings.

Acknowledgements

Special thanks go to:

  • Creative Labs for the original source code this is based off of.
  • Christopher Fitzgerald for the current reverb effect implementation, and helping with the low-pass and HRTF filters.
  • Christian Borss for the 3D panning code previous versions used as a base.
  • Ben Davis for the idea behind a previous version of the click-removal code.
  • Richard Furse for helping with my understanding of Ambisonics that is used by the various parts of the library.