TinyWav

A minimal C library for reading and writing (32-bit float or 16-bit int) WAV audio files. Designed for maximum portability.

TinyWav takes and provides audio samples in configurable channel formats (interleaved, split, inline). WAV files always store samples in interleaved format.
TinyWav is minimal: it can only read/write RIFF WAV files with sample format float32 or int16.
TinyWav does not allocate any memory on the heap. It uses alloca internally, which allocates on the stack. In practice, this restricts the block size to "reasonable" values, so watch out for stack overflows.
- In default TINYWAV_USE_ALLOCA mode, the read() and write() will return an error if the allocation exceeds 0.5 MegaBytes, which corresponds e.g. to reading/writing 8k 32-bit sample chunks for 16 channels.
- On platforms where alloca is not available (e.g. some DSP compilers), TINYWAV_USE_VLA or TINYWAV_USE_MALLOC can be defined for alternate allocation.

CI/CD: To guarantee portability, TinyWav is built and tested on several platforms, compilers & architectures:

Code Example

Writing

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_write(&tw,
NUM_CHANNELS,
SAMPLE_RATE,
TW_FLOAT32, // the output samples will be 32-bit floats. TW_INT16 is also supportedTW_INLINE, // the samples to be written will be assumed to be inlined in a single buffer.// Other options include TW_INTERLEAVED and TW_SPLIT"path/to/output.wav"// the output path
);
for (inti=0; i<100; i++) {
// NOTE: samples are always expected in float32 format, // regardless of file sample formatfloatsamples[BLOCK_SIZE*NUM_CHANNELS];
tinywav_write_f(&tw, samples, BLOCK_SIZE);
...
}
tinywav_close_write(&tw);

Reading

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_read(&tw, "path/to/input.wav",
TW_SPLIT// the samples will be delivered by the read function in split format
);
for (inti=0; i<100; i++) {
// samples are always provided in float32 format, // regardless of file sample formatfloatsamples[NUM_CHANNELS*BLOCK_SIZE];
// Split buffer requires pointers to channel buffersfloat*samplePtrs[NUM_CHANNELS];
for (intj=0; j<NUM_CHANNELS; ++j) {
samplePtrs[j] =samples+j*BLOCK_SIZE;
}
tinywav_read_f(&tw, samplePtrs, BLOCK_SIZE);
...
}
tinywav_close_read(&tw);

## Running the Tests

TinyWav relies on Cmake for its test builds. The automated tests are based on the Catch2 C++ test framework.

To run the tests, run one of the generator scripts in the test/scripts directory to generate a Xcode/VS project - or directly use Cmake in the commandline:

mkdir -p test/scripts/build
cd test/scripts/build
cmake ../../..
make
ctest # or run ./TinyWavTest directly

NOTE: The Git repository uses Git LFS to store some reference wav files as binaries. Make sure you have Git LFS installed/enabled/pulled before running the tests.

License

TinyWav is published under the ISC license. Please see the LICENSE file included in this repository, also reproduced below. In short, you are welcome to use this code for any purpose, including commercial and closed-source use.

Copyright (c) 2015-2023, Martin Roth <mhroth@gmail.com>
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

TinyWav

A minimal C library for reading and writing (32-bit float or 16-bit int) WAV audio files. Designed for maximum portability.

TinyWav takes and provides audio samples in configurable channel formats (interleaved, split, inline). WAV files always store samples in interleaved format.
TinyWav is minimal: it can only read/write RIFF WAV files with sample format float32 or int16.
TinyWav does not allocate any memory on the heap. It uses alloca internally, which allocates on the stack. In practice, this restricts the block size to "reasonable" values, so watch out for stack overflows.
- In default TINYWAV_USE_ALLOCA mode, the read() and write() will return an error if the allocation exceeds 0.5 MegaBytes, which corresponds e.g. to reading/writing 8k 32-bit sample chunks for 16 channels.
- On platforms where alloca is not available (e.g. some DSP compilers), TINYWAV_USE_VLA or TINYWAV_USE_MALLOC can be defined for alternate allocation.

CI/CD: To guarantee portability, TinyWav is built and tested on several platforms, compilers & architectures:

Code Example

Writing

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_write(&tw,
NUM_CHANNELS,
SAMPLE_RATE,
TW_FLOAT32, // the output samples will be 32-bit floats. TW_INT16 is also supportedTW_INLINE, // the samples to be written will be assumed to be inlined in a single buffer.// Other options include TW_INTERLEAVED and TW_SPLIT"path/to/output.wav"// the output path
);
for (inti=0; i<100; i++) {
// NOTE: samples are always expected in float32 format, // regardless of file sample formatfloatsamples[BLOCK_SIZE*NUM_CHANNELS];
tinywav_write_f(&tw, samples, BLOCK_SIZE);
...
}
tinywav_close_write(&tw);

Reading

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_read(&tw, "path/to/input.wav",
TW_SPLIT// the samples will be delivered by the read function in split format
);
for (inti=0; i<100; i++) {
// samples are always provided in float32 format, // regardless of file sample formatfloatsamples[NUM_CHANNELS*BLOCK_SIZE];
// Split buffer requires pointers to channel buffersfloat*samplePtrs[NUM_CHANNELS];
for (intj=0; j<NUM_CHANNELS; ++j) {
samplePtrs[j] =samples+j*BLOCK_SIZE;
}
tinywav_read_f(&tw, samplePtrs, BLOCK_SIZE);
...
}
tinywav_close_read(&tw);

## Running the Tests

TinyWav relies on Cmake for its test builds. The automated tests are based on the Catch2 C++ test framework.

To run the tests, run one of the generator scripts in the test/scripts directory to generate a Xcode/VS project - or directly use Cmake in the commandline:

mkdir -p test/scripts/build
cd test/scripts/build
cmake ../../..
make
ctest # or run ./TinyWavTest directly

NOTE: The Git repository uses Git LFS to store some reference wav files as binaries. Make sure you have Git LFS installed/enabled/pulled before running the tests.

License

TinyWav is published under the ISC license. Please see the LICENSE file included in this repository, also reproduced below. In short, you are welcome to use this code for any purpose, including commercial and closed-source use.

Copyright (c) 2015-2023, Martin Roth <mhroth@gmail.com>
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

TinyWav

A minimal C library for reading and writing (32-bit float or 16-bit int) WAV audio files. Designed for maximum portability.

TinyWav takes and provides audio samples in configurable channel formats (interleaved, split, inline). WAV files always store samples in interleaved format.
TinyWav is minimal: it can only read/write RIFF WAV files with sample format float32 or int16.
TinyWav does not allocate any memory on the heap. It uses alloca internally, which allocates on the stack. In practice, this restricts the block size to "reasonable" values, so watch out for stack overflows.
- In default TINYWAV_USE_ALLOCA mode, the read() and write() will return an error if the allocation exceeds 0.5 MegaBytes, which corresponds e.g. to reading/writing 8k 32-bit sample chunks for 16 channels.
- On platforms where alloca is not available (e.g. some DSP compilers), TINYWAV_USE_VLA or TINYWAV_USE_MALLOC can be defined for alternate allocation.

CI/CD: To guarantee portability, TinyWav is built and tested on several platforms, compilers & architectures:

Code Example

Writing

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_write(&tw,
NUM_CHANNELS,
SAMPLE_RATE,
TW_FLOAT32, // the output samples will be 32-bit floats. TW_INT16 is also supportedTW_INLINE, // the samples to be written will be assumed to be inlined in a single buffer.// Other options include TW_INTERLEAVED and TW_SPLIT"path/to/output.wav"// the output path
);
for (inti=0; i<100; i++) {
// NOTE: samples are always expected in float32 format, // regardless of file sample formatfloatsamples[BLOCK_SIZE*NUM_CHANNELS];
tinywav_write_f(&tw, samples, BLOCK_SIZE);
...
}
tinywav_close_write(&tw);

Reading

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_read(&tw, "path/to/input.wav",
TW_SPLIT// the samples will be delivered by the read function in split format
);
for (inti=0; i<100; i++) {
// samples are always provided in float32 format, // regardless of file sample formatfloatsamples[NUM_CHANNELS*BLOCK_SIZE];
// Split buffer requires pointers to channel buffersfloat*samplePtrs[NUM_CHANNELS];
for (intj=0; j<NUM_CHANNELS; ++j) {
samplePtrs[j] =samples+j*BLOCK_SIZE;
}
tinywav_read_f(&tw, samplePtrs, BLOCK_SIZE);
...
}
tinywav_close_read(&tw);

## Running the Tests

TinyWav relies on Cmake for its test builds. The automated tests are based on the Catch2 C++ test framework.

To run the tests, run one of the generator scripts in the test/scripts directory to generate a Xcode/VS project - or directly use Cmake in the commandline:

mkdir -p test/scripts/build
cd test/scripts/build
cmake ../../..
make
ctest # or run ./TinyWavTest directly

NOTE: The Git repository uses Git LFS to store some reference wav files as binaries. Make sure you have Git LFS installed/enabled/pulled before running the tests.

License

TinyWav is published under the ISC license. Please see the LICENSE file included in this repository, also reproduced below. In short, you are welcome to use this code for any purpose, including commercial and closed-source use.

Copyright (c) 2015-2023, Martin Roth <mhroth@gmail.com>
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

TinyWav

A minimal C library for reading and writing (32-bit float or 16-bit int) WAV audio files. Designed for maximum portability.

TinyWav takes and provides audio samples in configurable channel formats (interleaved, split, inline). WAV files always store samples in interleaved format.
TinyWav is minimal: it can only read/write RIFF WAV files with sample format float32 or int16.
TinyWav does not allocate any memory on the heap. It uses alloca internally, which allocates on the stack. In practice, this restricts the block size to "reasonable" values, so watch out for stack overflows.
- In default TINYWAV_USE_ALLOCA mode, the read() and write() will return an error if the allocation exceeds 0.5 MegaBytes, which corresponds e.g. to reading/writing 8k 32-bit sample chunks for 16 channels.
- On platforms where alloca is not available (e.g. some DSP compilers), TINYWAV_USE_VLA or TINYWAV_USE_MALLOC can be defined for alternate allocation.

CI/CD: To guarantee portability, TinyWav is built and tested on several platforms, compilers & architectures:

Code Example

Writing

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_write(&tw,
NUM_CHANNELS,
SAMPLE_RATE,
TW_FLOAT32, // the output samples will be 32-bit floats. TW_INT16 is also supportedTW_INLINE, // the samples to be written will be assumed to be inlined in a single buffer.// Other options include TW_INTERLEAVED and TW_SPLIT"path/to/output.wav"// the output path
);
for (inti=0; i<100; i++) {
// NOTE: samples are always expected in float32 format, // regardless of file sample formatfloatsamples[BLOCK_SIZE*NUM_CHANNELS];
tinywav_write_f(&tw, samples, BLOCK_SIZE);
...
}
tinywav_close_write(&tw);

Reading

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_read(&tw, "path/to/input.wav",
TW_SPLIT// the samples will be delivered by the read function in split format
);
for (inti=0; i<100; i++) {
// samples are always provided in float32 format, // regardless of file sample formatfloatsamples[NUM_CHANNELS*BLOCK_SIZE];
// Split buffer requires pointers to channel buffersfloat*samplePtrs[NUM_CHANNELS];
for (intj=0; j<NUM_CHANNELS; ++j) {
samplePtrs[j] =samples+j*BLOCK_SIZE;
}
tinywav_read_f(&tw, samplePtrs, BLOCK_SIZE);
...
}
tinywav_close_read(&tw);

## Running the Tests

TinyWav relies on Cmake for its test builds. The automated tests are based on the Catch2 C++ test framework.

To run the tests, run one of the generator scripts in the test/scripts directory to generate a Xcode/VS project - or directly use Cmake in the commandline:

mkdir -p test/scripts/build
cd test/scripts/build
cmake ../../..
make
ctest # or run ./TinyWavTest directly

NOTE: The Git repository uses Git LFS to store some reference wav files as binaries. Make sure you have Git LFS installed/enabled/pulled before running the tests.

License

TinyWav is published under the ISC license. Please see the LICENSE file included in this repository, also reproduced below. In short, you are welcome to use this code for any purpose, including commercial and closed-source use.

Copyright (c) 2015-2023, Martin Roth <mhroth@gmail.com>
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

TinyWav

A minimal C library for reading and writing (32-bit float or 16-bit int) WAV audio files. Designed for maximum portability.

TinyWav takes and provides audio samples in configurable channel formats (interleaved, split, inline). WAV files always store samples in interleaved format.
TinyWav is minimal: it can only read/write RIFF WAV files with sample format float32 or int16.
TinyWav does not allocate any memory on the heap. It uses alloca internally, which allocates on the stack. In practice, this restricts the block size to "reasonable" values, so watch out for stack overflows.
- In default TINYWAV_USE_ALLOCA mode, the read() and write() will return an error if the allocation exceeds 0.5 MegaBytes, which corresponds e.g. to reading/writing 8k 32-bit sample chunks for 16 channels.
- On platforms where alloca is not available (e.g. some DSP compilers), TINYWAV_USE_VLA or TINYWAV_USE_MALLOC can be defined for alternate allocation.

CI/CD: To guarantee portability, TinyWav is built and tested on several platforms, compilers & architectures:

Code Example

Writing

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_write(&tw,
NUM_CHANNELS,
SAMPLE_RATE,
TW_FLOAT32, // the output samples will be 32-bit floats. TW_INT16 is also supportedTW_INLINE, // the samples to be written will be assumed to be inlined in a single buffer.// Other options include TW_INTERLEAVED and TW_SPLIT"path/to/output.wav"// the output path
);
for (inti=0; i<100; i++) {
// NOTE: samples are always expected in float32 format, // regardless of file sample formatfloatsamples[BLOCK_SIZE*NUM_CHANNELS];
tinywav_write_f(&tw, samples, BLOCK_SIZE);
...
}
tinywav_close_write(&tw);

Reading

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_read(&tw, "path/to/input.wav",
TW_SPLIT// the samples will be delivered by the read function in split format
);
for (inti=0; i<100; i++) {
// samples are always provided in float32 format, // regardless of file sample formatfloatsamples[NUM_CHANNELS*BLOCK_SIZE];
// Split buffer requires pointers to channel buffersfloat*samplePtrs[NUM_CHANNELS];
for (intj=0; j<NUM_CHANNELS; ++j) {
samplePtrs[j] =samples+j*BLOCK_SIZE;
}
tinywav_read_f(&tw, samplePtrs, BLOCK_SIZE);
...
}
tinywav_close_read(&tw);

## Running the Tests

TinyWav relies on Cmake for its test builds. The automated tests are based on the Catch2 C++ test framework.

To run the tests, run one of the generator scripts in the test/scripts directory to generate a Xcode/VS project - or directly use Cmake in the commandline:

mkdir -p test/scripts/build
cd test/scripts/build
cmake ../../..
make
ctest # or run ./TinyWavTest directly

NOTE: The Git repository uses Git LFS to store some reference wav files as binaries. Make sure you have Git LFS installed/enabled/pulled before running the tests.

License

TinyWav is published under the ISC license. Please see the LICENSE file included in this repository, also reproduced below. In short, you are welcome to use this code for any purpose, including commercial and closed-source use.

Copyright (c) 2015-2023, Martin Roth <mhroth@gmail.com>
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

TinyWav

A minimal C library for reading and writing (32-bit float or 16-bit int) WAV audio files. Designed for maximum portability.

TinyWav takes and provides audio samples in configurable channel formats (interleaved, split, inline). WAV files always store samples in interleaved format.
TinyWav is minimal: it can only read/write RIFF WAV files with sample format float32 or int16.
TinyWav does not allocate any memory on the heap. It uses alloca internally, which allocates on the stack. In practice, this restricts the block size to "reasonable" values, so watch out for stack overflows.
- In default TINYWAV_USE_ALLOCA mode, the read() and write() will return an error if the allocation exceeds 0.5 MegaBytes, which corresponds e.g. to reading/writing 8k 32-bit sample chunks for 16 channels.
- On platforms where alloca is not available (e.g. some DSP compilers), TINYWAV_USE_VLA or TINYWAV_USE_MALLOC can be defined for alternate allocation.

CI/CD: To guarantee portability, TinyWav is built and tested on several platforms, compilers & architectures:

Code Example

Writing

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_write(&tw,
NUM_CHANNELS,
SAMPLE_RATE,
TW_FLOAT32, // the output samples will be 32-bit floats. TW_INT16 is also supportedTW_INLINE, // the samples to be written will be assumed to be inlined in a single buffer.// Other options include TW_INTERLEAVED and TW_SPLIT"path/to/output.wav"// the output path
);
for (inti=0; i<100; i++) {
// NOTE: samples are always expected in float32 format, // regardless of file sample formatfloatsamples[BLOCK_SIZE*NUM_CHANNELS];
tinywav_write_f(&tw, samples, BLOCK_SIZE);
...
}
tinywav_close_write(&tw);

Reading

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_read(&tw, "path/to/input.wav",
TW_SPLIT// the samples will be delivered by the read function in split format
);
for (inti=0; i<100; i++) {
// samples are always provided in float32 format, // regardless of file sample formatfloatsamples[NUM_CHANNELS*BLOCK_SIZE];
// Split buffer requires pointers to channel buffersfloat*samplePtrs[NUM_CHANNELS];
for (intj=0; j<NUM_CHANNELS; ++j) {
samplePtrs[j] =samples+j*BLOCK_SIZE;
}
tinywav_read_f(&tw, samplePtrs, BLOCK_SIZE);
...
}
tinywav_close_read(&tw);

## Running the Tests

TinyWav relies on Cmake for its test builds. The automated tests are based on the Catch2 C++ test framework.

To run the tests, run one of the generator scripts in the test/scripts directory to generate a Xcode/VS project - or directly use Cmake in the commandline:

mkdir -p test/scripts/build
cd test/scripts/build
cmake ../../..
make
ctest # or run ./TinyWavTest directly

NOTE: The Git repository uses Git LFS to store some reference wav files as binaries. Make sure you have Git LFS installed/enabled/pulled before running the tests.

License

TinyWav is published under the ISC license. Please see the LICENSE file included in this repository, also reproduced below. In short, you are welcome to use this code for any purpose, including commercial and closed-source use.

Copyright (c) 2015-2023, Martin Roth <mhroth@gmail.com>
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

TinyWav

A minimal C library for reading and writing (32-bit float or 16-bit int) WAV audio files. Designed for maximum portability.

TinyWav takes and provides audio samples in configurable channel formats (interleaved, split, inline). WAV files always store samples in interleaved format.
TinyWav is minimal: it can only read/write RIFF WAV files with sample format float32 or int16.
TinyWav does not allocate any memory on the heap. It uses alloca internally, which allocates on the stack. In practice, this restricts the block size to "reasonable" values, so watch out for stack overflows.
- In default TINYWAV_USE_ALLOCA mode, the read() and write() will return an error if the allocation exceeds 0.5 MegaBytes, which corresponds e.g. to reading/writing 8k 32-bit sample chunks for 16 channels.
- On platforms where alloca is not available (e.g. some DSP compilers), TINYWAV_USE_VLA or TINYWAV_USE_MALLOC can be defined for alternate allocation.

CI/CD: To guarantee portability, TinyWav is built and tested on several platforms, compilers & architectures:

Code Example

Writing

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_write(&tw,
NUM_CHANNELS,
SAMPLE_RATE,
TW_FLOAT32, // the output samples will be 32-bit floats. TW_INT16 is also supportedTW_INLINE, // the samples to be written will be assumed to be inlined in a single buffer.// Other options include TW_INTERLEAVED and TW_SPLIT"path/to/output.wav"// the output path
);
for (inti=0; i<100; i++) {
// NOTE: samples are always expected in float32 format, // regardless of file sample formatfloatsamples[BLOCK_SIZE*NUM_CHANNELS];
tinywav_write_f(&tw, samples, BLOCK_SIZE);
...
}
tinywav_close_write(&tw);

Reading

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_read(&tw, "path/to/input.wav",
TW_SPLIT// the samples will be delivered by the read function in split format
);
for (inti=0; i<100; i++) {
// samples are always provided in float32 format, // regardless of file sample formatfloatsamples[NUM_CHANNELS*BLOCK_SIZE];
// Split buffer requires pointers to channel buffersfloat*samplePtrs[NUM_CHANNELS];
for (intj=0; j<NUM_CHANNELS; ++j) {
samplePtrs[j] =samples+j*BLOCK_SIZE;
}
tinywav_read_f(&tw, samplePtrs, BLOCK_SIZE);
...
}
tinywav_close_read(&tw);

## Running the Tests

TinyWav relies on Cmake for its test builds. The automated tests are based on the Catch2 C++ test framework.

To run the tests, run one of the generator scripts in the test/scripts directory to generate a Xcode/VS project - or directly use Cmake in the commandline:

mkdir -p test/scripts/build
cd test/scripts/build
cmake ../../..
make
ctest # or run ./TinyWavTest directly

NOTE: The Git repository uses Git LFS to store some reference wav files as binaries. Make sure you have Git LFS installed/enabled/pulled before running the tests.

License

TinyWav is published under the ISC license. Please see the LICENSE file included in this repository, also reproduced below. In short, you are welcome to use this code for any purpose, including commercial and closed-source use.

Copyright (c) 2015-2023, Martin Roth <mhroth@gmail.com>
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

TinyWav

A minimal C library for reading and writing (32-bit float or 16-bit int) WAV audio files. Designed for maximum portability.

TinyWav takes and provides audio samples in configurable channel formats (interleaved, split, inline). WAV files always store samples in interleaved format.
TinyWav is minimal: it can only read/write RIFF WAV files with sample format float32 or int16.
TinyWav does not allocate any memory on the heap. It uses alloca internally, which allocates on the stack. In practice, this restricts the block size to "reasonable" values, so watch out for stack overflows.
- In default TINYWAV_USE_ALLOCA mode, the read() and write() will return an error if the allocation exceeds 0.5 MegaBytes, which corresponds e.g. to reading/writing 8k 32-bit sample chunks for 16 channels.
- On platforms where alloca is not available (e.g. some DSP compilers), TINYWAV_USE_VLA or TINYWAV_USE_MALLOC can be defined for alternate allocation.

CI/CD: To guarantee portability, TinyWav is built and tested on several platforms, compilers & architectures:

Code Example

Writing

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_write(&tw,
NUM_CHANNELS,
SAMPLE_RATE,
TW_FLOAT32, // the output samples will be 32-bit floats. TW_INT16 is also supportedTW_INLINE, // the samples to be written will be assumed to be inlined in a single buffer.// Other options include TW_INTERLEAVED and TW_SPLIT"path/to/output.wav"// the output path
);
for (inti=0; i<100; i++) {
// NOTE: samples are always expected in float32 format, // regardless of file sample formatfloatsamples[BLOCK_SIZE*NUM_CHANNELS];
tinywav_write_f(&tw, samples, BLOCK_SIZE);
...
}
tinywav_close_write(&tw);

Reading

#include"tinywav.h"#defineNUM_CHANNELS 2
#defineSAMPLE_RATE 48000
#defineBLOCK_SIZE 480
TinyWavtw;
tinywav_open_read(&tw, "path/to/input.wav",
TW_SPLIT// the samples will be delivered by the read function in split format
);
for (inti=0; i<100; i++) {
// samples are always provided in float32 format, // regardless of file sample formatfloatsamples[NUM_CHANNELS*BLOCK_SIZE];
// Split buffer requires pointers to channel buffersfloat*samplePtrs[NUM_CHANNELS];
for (intj=0; j<NUM_CHANNELS; ++j) {
samplePtrs[j] =samples+j*BLOCK_SIZE;
}
tinywav_read_f(&tw, samplePtrs, BLOCK_SIZE);
...
}
tinywav_close_read(&tw);

## Running the Tests

TinyWav relies on Cmake for its test builds. The automated tests are based on the Catch2 C++ test framework.

To run the tests, run one of the generator scripts in the test/scripts directory to generate a Xcode/VS project - or directly use Cmake in the commandline:

mkdir -p test/scripts/build
cd test/scripts/build
cmake ../../..
make
ctest # or run ./TinyWavTest directly

NOTE: The Git repository uses Git LFS to store some reference wav files as binaries. Make sure you have Git LFS installed/enabled/pulled before running the tests.

License

TinyWav is published under the ISC license. Please see the LICENSE file included in this repository, also reproduced below. In short, you are welcome to use this code for any purpose, including commercial and closed-source use.

Copyright (c) 2015-2023, Martin Roth <mhroth@gmail.com>
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
test		test
.gitattributes		.gitattributes
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md
tinywav.c		tinywav.c
tinywav.h		tinywav.h

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
test		test
.gitattributes		.gitattributes
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md
tinywav.c		tinywav.c
tinywav.h		tinywav.h

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
test		test
.gitattributes		.gitattributes
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md
tinywav.c		tinywav.c
tinywav.h		tinywav.h

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
test		test
.gitattributes		.gitattributes
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md
tinywav.c		tinywav.c
tinywav.h		tinywav.h

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
test		test
.gitattributes		.gitattributes
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md
tinywav.c		tinywav.c
tinywav.h		tinywav.h

Latest commit

History

Folders and files

Repository files navigation

TinyWav

Code Example

Writing

Reading

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

TinyWav

Code Example

Writing

Reading

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

TinyWav

Code Example

Writing

Reading

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

TinyWav

Code Example

Writing

Reading

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation