VGAudio is a library for encoding, decoding, and manipulating audio files and formats that are usually found in video games.
The most recent release of the library can be found on NuGet
The Universal Windows app can be found in the Windows Store
| Format | Encode | Decode | Notes |
|---|---|---|---|
| ATRAC9 | X | MDCT-based codec from Sony | |
| CRI ADX | X | X | 4-bit ADPCM codec from CRI |
| CRI HCA | X | X | MDCT-based codec from CRI |
| Nintendo GC-ADPCM | X | X | 4-bit ADPCM codec from Nintendo |
| PCM 8-bit | X | X | Signed and unsigned |
| PCM 16-bit | X | X |
| Container | Write | Read | Notes |
|---|---|---|---|
| AT9 | X | X | |
| BCSTM | X | X | |
| BCSTP | X | ||
| BCWAV | X | ||
| BFSTM | X | X | |
| BFSTP | X | ||
| BFWAV | X | ||
| BRSTM | X | X | |
| BRWAV | X | ||
| DSP (Nintendo) | X | X | |
| GENH | X | GC-ADPCM only | |
| HCA | X | X | |
| HPS | X | X | HAL Laboratory "HALPST" container for GC-ADPCM audio |
| IDSP (Interleaved Nintendo DSP) | X | X | |
| MDSP | X | X | Multi-channel Nintendo DSP |
| WAV | X | X |
The tool VGAudioCli provides a command-line interface (CLI) to convert audio files supported by the VGAudio library.
Convert to another file type. The file-types are inferred from the file extensions:
VGAudioCli input.wav output.dsp
Files can be listed in any order:
VGAudioCli -o output.dsp -i input.wav
Loop a file from samples 30000 to 200000:
VGAudioCli input.wav output.dsp -l 30000-200000
Show file metadata:
VGAudioCli -m input.wav
Specify output audio format if the output container supports multiple audio formats.
Save as a BRSTM file with PCM 16-bit audio:
VGAudioCli input.wav output.brstm -f pcm16
Output only channels 0,1,2, and 5 from the input file:
VGAudioCli -i:0-2,5 input.wav output.dsp
Combine two mono files into a stereo file. (Input files must have the same length)
VGAudioCli -i input_left.wav -i input_right.wav output_stereo.dsp
Take channels 0 and 3 from input1.wav, channel 1 from input2.dsp, and all the channels in input3.adx and save them as output.hca:
VGAudioCli -i:0,3 input1.wav -i:1 input2.dsp -i input3.adx output.hca
Batch conversion allows an entire folder of files to be converted at a time. These conversions are done in parallel, and will be faster the more CPU cores you have.
Batch mode is used by inputting -b or --batch as the first command-line argument. Unlike single-file conversions, you must explicitly specify the output file type in batch conversions.
Convert all the files in the source folder to HCA files, and save them in the dest folder:
VGAudioCli -b -i source -o dest --out-format hca
Convert all the files in the source folder and all its subfolders to HCA files, and save them in the dest folder:
VGAudioCli -b -r -i source -o dest --out-format hca
Other options can also be specified during batch conversion.
Remove the loop points from any converted files:
VGAudioCli -b -i source -o dest --out-format hca --no-loop
Codec-specific options can be specified as well:
VGAudioCli -b -i source -o dest --out-format hca --hcaquality low
Depending on which format is used, when the input and output files are the same audio format, the conversion is often lossless. For example, both the DSP and BRSTM containers contain GC-ADPCM audio, so converting a DSP file to a BRSTM file would be a lossless conversion. The encoded audio data is read from the DSP file and repackaged into a BRSTM file without any modification.
The channels from some formats like ADX and GC-ADPCM can be losslessly split and combined. For example, a stereo ADX file can be split into two mono ADX files without any loss of quality. Conversely, two stereo ADX files can be combined into a single 4-channel ADX file.
Because no audio encoding is done, these types of conversions are very quick compared to normal conversions.