Resamplers and Wavtools - stakira/OpenUtau GitHub Wiki (2024)

Windows

Resampler must be an executable (.exe). Resamplers can be placed in subfolders inside the Resamplers folder.

1. In the OpenUtau folder, locate the resampler folder named Resamplers.
2. Open the resampler folder and place the resampler in the folder.

In OpenUtau version 0.1.119 or higher, resamplers can be installed by dragging and dropping the .exe file onto the main OpenUtau window and selecting "Install as resampler".

macOS

As of macOS 11.6, the below method works.

1. Install homebrew
2. Install wine32on64 using following commands:

brew tap gcenx/winebrew install --cask --no-quarantine wine-crossover

3. Download "mac_additional.zip" from the release page.
4. Use the moresampler.sh script inside the mac_additional.zip to wrap the resampler: Replace moresampler-0.8.4/moresampler.exe with the filename of the resampler.

This script will need to be added to the Resamplers folder and edited for every .exe resampler that is added.

Linux

For wrapping Windows resamplers into Linux, use this method:

1. Install Wine
2. Open the Resamplers folder (should be on /home/your_username/OpenUtau/Resamplers/)
3. Create a new text file with the name of your resampler (no file extension required).
4. Open the text file and add this script.

#!/bin/bashLANG="ja_JP.UTF8" wine "/absolute/path/to/your/resampler.exe" "${@,-1}"

5. Change "/absolute/path/to/your/resampler.exe" to the filename of the resampler.
6. Restart OpenUtau.

This is a list of all UTAU resamplers tested with OpenUtau.

Compatible with adjustments

• moresampler.exe
  • Add moresampler.exe and the default moreconfig.txt to the Resamplers folder.
  • Add moresampler.exe to Wavtools folder without moreconfig.txt.
  • Moresampler should now function as either resampler only, or as both wavtool and resampler.
• SpaceWorld_win64.exe and wn4u.exe
  • May experience issues if the voicebank is missing any frq files. SpaceWorld version 1.0.1 will not crash in the event of a missing frq file.
• lessampler
  • In development, lack of flag support
  • Oversized Audio Model Attention

A resampler manifest is a YAML file used to store the expressions supported by a resampler. With resampler manifests, users can add all of a resampler's supported flags at once using the Add all expressions suggested by renderers button in the Expressions editor.

Resampler manifests should have the same name as the resampler executable, stored in the same folder. The manifest must have a .yaml file extension. For example, the resampler manifest for moresampler.exe should be moresampler.yaml located in the same folder with moresampler.exe.

Below is a full example of a resampler manifest for Moresampler. To create a resampler manifest with OpenUtau, add the resampler's expressions to any .ustx project file. Open the project file in a text editor and copy the expressions: section into a blank manifest file.

expressions: gen: name: Gender Factor abbr: gen type: Numerical min: -100 max: 100 default_value: 0 is_flag: true flag: g mbre: name: Breathiness (Moresampler) abbr: mbre type: Numerical min: -100 max: 100 default_value: 0 is_flag: true flag: Mb tens: name: Tension abbr: tens type: Numerical min: -100 max: 100 default_value: 0 is_flag: true flag: Mt pit: name: Pitch deviation (flag) abbr: pit type: Numerical min: -1200 max: 1200 default_value: 0 is_flag: true flag: t pkcp: name: Peak Compressor abbr: pkcp type: Numerical min: 0 max: 100 default_value: 86 is_flag: true flag: P amp: name: Amplitude Modulation abbr: amp type: Numerical min: -100 max: 100 default_value: 0 is_flag: true flag: A cons: name: Unvoiced Consonant Gain abbr: cons type: Numerical min: -20 max: 100 default_value: 0 is_flag: true flag: b fstr: name: Force Stretch abbr: fstr type: Options min: 0 max: 1 default_value: 0 is_flag: true options: - '' - e - Me opn: name: Openness abbr: opn type: Numerical min: -100 max: 100 default_value: 0 is_flag: true flag: Mo res: name: Resonance abbr: res type: Numerical min: -100 max: 100 default_value: 0 is_flag: true flag: Mr dry: name: Dryness abbr: dry type: Numerical min: -100 max: 100 default_value: 0 is_flag: true flag: Md cors: name: Coarseness abbr: cors type: Numerical min: 0 max: 100 default_value: 0 is_flag: true flag: MC grwl: name: Growl abbr: grwl type: Numerical min: 0 max: 100 default_value: 0 is_flag: true flag: MG dist: name: Distortion abbr: dist type: Numerical min: 0 max: 100 default_value: 0 is_flag: true flag: MD stbl: name: Stabilization abbr: stbl type: Numerical min: 0 max: 10 default_value: 0 is_flag: true flag: Ms mint: name: Model Interpolation abbr: mint type: Numerical min: 0 max: 100 default_value: 100 is_flag: true flag: Mm

Windows

1. On your unzipped OpenUtau folder, locate the wavtool folder named Wavtools.
2. Open the wavtool folder and place the downloaded wavtool on the folder.

In OpenUtau version 0.1.119 or higher, wavtools can be installed by dragging and dropping the .exe file onto the main OpenUtau window and selecting "Install as wavtool".

macOS / Linux

External wavtools are not supported on macOS or Linux at this time.

Below is a list of all UTAU wavtools tested with OpenUtau.