A simple header-only C++ library for reading and writing audio files.
Current supported formats:
- WAV
- AIFF
AudioFile is written and maintained by Adam Stark.
#include "AudioFile.h"
AudioFile<double> audioFile;
audioFile.load ("/path/to/my/audiofile.wav");
int sampleRate = audioFile.getSampleRate();
int bitDepth = audioFile.getBitDepth();
int numSamples = audioFile.getNumSamplesPerChannel();
double lengthInSeconds = audioFile.getLengthInSeconds();
int numChannels = audioFile.getNumChannels();
bool isMono = audioFile.isMono();
bool isStereo = audioFile.isStereo();
// or, just use this quick shortcut to print a summary to the console
audioFile.printSummary();
int channel = 0;
int numSamples = audioFile.getNumSamplesPerChannel();
for (int i = 0; i < numSamples; i++)
{
double currentSample = audioFile.samples[channel][i];
}
// 1. Create an AudioBuffer
// (BTW, AudioBuffer is just a vector of vectors)
AudioFile<double>::AudioBuffer buffer;
// 2. Set to (e.g.) two channels
buffer.resize (2);
// 3. Set number of samples per channel
buffer[0].resize (100000);
buffer[1].resize (100000);
// 4. do something here to fill the buffer with samples, e.g.
#include <math.h> // somewhere earler (for M_PI and sinf())
// then...
int numChannels = 2;
int numSamplesPerChannel = 100000;
float sampleRate = 44100.f;
float frequency = 440.f;
for (int i = 0; i < numSamplesPerChannel; i++)
{
float sample = sinf (2. * M_PI * ((float) i / sampleRate) * frequency) ;
for (int channel = 0; channel < numChannels; channel++)
buffer[channel][i] = sample * 0.5;
}
// 5. Put into the AudioFile object
bool ok = audioFile.setAudioBuffer (buffer);
// Set both the number of channels and number of samples per channel
audioFile.setAudioBufferSize (numChannels, numSamples);
// Set the number of samples per channel
audioFile.setNumSamplesPerChannel (numSamples);
// Set the number of channels
audioFile.setNumChannels (int numChannels);
audioFile.setBitDepth (24);
audioFile.setSampleRate (44100);
// Wave file (implicit)
audioFile.save ("path/to/desired/audioFile.wav");
// Wave file (explicit)
audioFile.save ("path/to/desired/audioFile.wav", AudioFileFormat::Wave);
// Aiff file
audioFile.save ("path/to/desired/audioFile.aif", AudioFileFormat::Aiff);
Please see the examples folder for some examples on library usage.
AudioFile is a template class and so it can be instantiated using floating point precision:
AudioFile<float> audioFile;
...or double precision:
AudioFile<double> audioFile;
This simply reflects the data type you would like to use to store the underlying audio samples. You can still read or write 8, 16 or 24-bit audio files, regardless of the type that you use (unless your system uses a precision for floats less than your desired bit depth).
I have heard of people using the library with other types, but I have not designed for those cases. Let me know if you are interested in this supporting a specific type more formally.
By default, the library logs error messages to the console to provide information on what has gone wrong (e.g. a file we tried to load didn't exist).
If you prefer not to see these messages, you can disable this error logging behaviour using:
audioFile.shouldLogErrorsToConsole (false);
- Faster loading of audio files
- Bug fixes
- CMake support
- Construct instances with a file path
- Bug fixes
- Support for 32-bit audio files
- Support for multi-channel audio files
- Reading/writing of iXML data chunks
- Made error logging to the console optional
- Fixed lots of compiler warnings
- Added include of to better support Visual Studio
- Changed to a header-only library. Now you can just include AudioFile.h
- Bug fixes
- Bug fixes
- Documentation updates
- Bug fixes
- Multichannel (i.e. >2 channels) audio file support (Sidelobe)
- Read/write of iXML data chunks (mynameisjohn)
- Remove warnings (Abhinav1997)
- Better support on Ubuntu (BenjaminHinchliff)
- Faster loading of audio files (helloimmatt)
If you would like to submit a pull request for this library, please do! But kindly follow the following simple guidelines...
- Make the changes as concise as is possible for the change you are proposing
- Avoid unnecessarily changing a large number of lines - e.g. commits changing the number of spaces in indentations on all lines (and so on)
- Keep to the code style of this library which is the JUCE Coding Standards
Copyright (c) 2017 Adam Stark
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.