TALCS: Audio Library of CrSjimo
-
Core
The core module includes basic buffers, sources, and utilities for audio processing. The core module is required by all other modules.
-
Essential Modules
-
Device
The device module includes functionalities for outputting audio to the device.
-
Format
The format module includes functionalities for accessing formatted audio files.
-
MIDI
The MIDI module can process MIDI messages, read inputs from MIDI devices, and do MIDI-related audio processing.
-
-
Additional Modules
-
ASIO (requires: Device, Windows)
The ASIO module provides the ASIO audio driver under GPL-3.0-only. Enable the module with
TALCS_ASIO. -
Remote (requires: Device, MIDI)
The remote module provides interfaces to communicate with the remote audio bridge. See talcs-remote.
-
JUCE Adapter
The JUCE adapter module provides adapters for some classes in JUCE.
-
DSPX (requires: Format)
The DSPX module includes classes for building up the audio-processing context in DSPX editor applications.
-
GUI
The GUI modules includes some audio utilities relevant to the GUI.
-
Essential modules will be built by default, and additional modules will not be built by default. To enable or disable the build of a module, set the corresponding CMake option on or off.
The device module includes native WASAPI and WASAPI (Exclusive Mode) drivers through IAudioClient3 on Windows and CoreAudio and CoreAudio (Hog Mode) drivers through the HAL Output Audio Unit on macOS. The CoreAudio shared driver preserves hardware settings, exposes the current hardware buffer size, and passes each native output buffer directly to the audio callback. A hardware buffer size change closes the shared device and refreshes its capabilities. The Hog driver acquires exclusive device access, configures the hardware sample rate and buffer size, and restores the hardware settings before releasing the device. Linux provides PipeWire, PulseAudio, JACK, and ALSA in preference order through the separate talcs::PipeWire, talcs::PulseAudio, talcs::Jack, and talcs::Alsa libraries. All built-in drivers for the target platform are registered by AudioDriverManager::createBuiltInDriverManager(). The ASIO module exports talcs::ASIOAudioDriver for registration with AudioDriverManager::addAudioDriver().
-
Qt (tested on 5.15.2 and 6.5.3)
-
PipeWire (used by: PipeWire)
-
PulseAudio (used by: PulseAudio)
-
JACK (used by: Jack)
-
ALSA (used by: Alsa)
-
libsndfile/libsndfile (used by: Format)
-
ASIO SDK (used by: ASIO)
-
avaneev/r8brain-free-src (used by: Format)
-
dbry/WavPack (used by: Format)
-
thestk/rtmidi (used by: MIDI)
-
rpclib/rpclib (used by: Remote)
-
Boost (used by: Remote)
-
JUCE (used by: JUCE Adapter)
-
Build Dependencies
TALCS uses vcpkg to manage dependency libraries, except Qt, r8brain, and JUCE:
-
The port files of interval-tree and qmsetup are in stdware/vcpkg-overlay. The documentation about how to install libraries is also in this repository. This repository is included as a submodule in
scripts/vcpkg. -
Qt should be installed manually.
-
The ASIO module uses only headers from the
asiosdkvcpkg package. -
r8brain is included as a submodule in the TALCS repository.
-
JUCE should be manually specified in the CMake option
JUCE_DIRto make CMake find it.
The ASIO module is licensed under GPL-3.0-only. The following terms apply to the other TALCS modules.
TALCS is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
TALCS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with TALCS. If not, see https://www.gnu.org/licenses/.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".