Skip to content

cbdevnet/cswave

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cswave

cswave is a small, cross-platform utility to convert CSV sample data to WAVE files. This can be used to do further analysis or processing on the data using audio tooling.

Any column of the input file can be used as sample data for a resulting monophonic wave file, in one of the supported formats

  • i8: 8 bit unsigned integer data
  • i16: 16bit signed little-endian data
  • i32: 32bit signed little-endian data
  • f32: 32bit IEEE float data
  • nf32: 32bit IEEE float data, but without the normalization step

Note that the integer output data formats only use the integer part of the input data, ie. when using the i32 output format, the input sample value 1.23 is truncated to the output sample value 1.

When using the integer output data formats, the exact sample value is preserved (as long as it fits the storage size). For the f32 format, the specification requires that the samples be normalized to the range -1.0 to 1.0, thus the sample values will not be preserved. Use the nf32 sample format when your input data is already normalized and you want to preserve the exact sample values.

Quoted text embedding the separation character within CSV columns will confuse the CSV parser. Don't do that.

Building

To build cswave, running make within the project directory on a machine with a working C compiler should work.

To build the windows executable cswave.exe, the mingw-w64 crosscompiler is required. Use make cswave.exe to build it.

Usage

Call the tool using the invocation

./cswave <file.csv> <file.wav> <column> <samplerate> [<format>] [<delimiter>]
  • <file.csv>: CSV input file
  • <file.wav>: Output file, will be overwritten without question if it already exists
  • <column>: Zero-based column index within the CSV (e.g., 0)
  • <samplerate>: Integer sample rate of the resulting output file (e.g., 44100)
  • <format>: Output file sample format as listed above, default i16
  • <delimiter>: Specify a single character to use as the delimiter within the CSV input, default ,