shmishtopher / VAU

📀 The Vocaloid Archive Utility

vau is a tool for unpacking vocaloid voicebanks (.ddb files) into wave files. vau enables you to extract voicebanks quickly and with a variety of export options. Support for repacking voicebanks is planned for the future.

Usage

Getting help

> vau help

Extract an archive into a single wave file called samples.wav

> vau unpack /PATH/TO/ARCHIVE.ddb -w samples.wav

Extract all of the samples in an archive to a folder called samples/

> vau unpack /PATH/TO/ARCHIVE.ddb samples

Extract an archive with a different sample rate

> vau unpack /PATH/TO/ARCHIVE.ddb -w samples.wav -r 44100

Extracting an archive with a different bit depth and sample rate

> vau unpack /PATH/TO/ARCHIVE.ddb -w samples.wav -r 44100 -b 16

All flags

-h, --help       Prints help information
-V, --version    Prints version information

All Options

-b, --bits <bit_depth>      Configures the bit depth for of the samples, defaults to 32
-r, --rate <sample_rate>    Configures the sample rate of the samples, defaults to 22050
-w, --wav  <wave_file>      Concatenate and emit samples to a single wav file called <wave_file>

Usage

> vau unpack [OPTIONS] <archive> [output]

Installation

To install vau, head over to the releases page or click here and select the latest version of vau compatible with your operating system. Place vau in your working directory or add it to your path to invoke it anywhere.

Contributing

Want to see a feature added? Found a bug? Just want to join the discussion? Open an issue or submit a pull request! When submitting a bug report, please make sure you include a description of the expected behavior as well as the steps required to reproduce the error.