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.

vau's Issues

V1 Support?

I got vau working perfectly when unpacking .ddb files from V3 voicebanks. But when unpacking a V1 voicebank, I received a windows popup saying "This app can't run on your PC". Is there a way to get past this? Thank you.

Need A More Comprehensive Tutorial

I don't know anything about coding, let alone Rust, so I need a more comprehensive step-by-step tutorial on how this works? What is my "working directory" and how do I add it to my path?? I am incredibly and deeply lost, but determined to figure this out.

Add repacking features

Not a bug, but I want to see a repacking feature on VAU.
I know you said that you want to add this feature in the future, but it's not yet implemented.