Soundpipe is a lightweight music DSP library written in C. It aims to provide a set of high-quality DSP modules for composers, sound designers, and creative coders.
- A great set of high-quality modules ported directly from the Csound library
- Sample accurate timing
- Tiny codebase
- Static library
- Easily extendable
- Easily embeddable
Soundpipe is primarily desgined to generate wav files, however there are optional modules which allow Soundpipe to be run in realtime via JACK or from a Raspberry Pi (ALSA). See the compilation section for how to enable these.
By default, Soundpipe only needs libsndfile. To compile on Linux:
make
sudo make install
To build additional plugins with external library dependencies, uncomment lines in the file "config.mk".
To build the examples, go into the (e)xamples folder and run "make". Each example will generate a 5 second file called "test.wav". Examples in the "extra" folder are for optional modules. Open up the Makefile and uncomment the specific files you want to compile.
On Mac, clone the repository located here: https://github.com/erikd/libsndfile/
Then, run the following command:
sh autogen.sh
If you are missing any dependencies, get them using a package manager like brew or port, and run the above command again.
Next, run the following commands:
./configure
make
sudo make install
Soundpipe should now successfully be installed.
- multi-channel support (only mono right now)
- dynamic documentation generation (HTML, LaTeX, manpage, etc...)
- Faust support
- Commandline utilities
Soundpipe is callback driven. Every time Soundpipe needs a frame, it will call upon a single function specified by the user. Soundpipe modules are designed to process a signal, one sample at a time. Every module follows the same life cycle:
- Create: Memory is allocated for the data struct.
- Initialize: Buffers are allocated, and initial variables and constants are set.
- Compute: the module takes in inputs (if applicable), and generates a single sample of output.
- Destroy: All memory allocated is freed.
If you have lua installed on your computer, you can generate the current html documentation for soundpipe by running "make docs". A folder called "docs" will be created. The top page for the documentation is docs/index.html.
Paul Batchelor
Alex Tape
Daniel Friedman