Skip to content

Resamplers and Wavtools

Ryan Wong edited this page Aug 12, 2024 · 27 revisions

In UTAU, resampler is the core engine that does the major works of synthesis: changing the pitch and duration of the audio sample, and applying flags to the audio. Audio rendered with different resamplers has different sound quality. Different resamplers also provide different set of flags. OpenUtau ships with a resampler, worldline. There are also many third-party resamplers.

Wavtool is the program that concatenates the audio slices from resampler into the final audio. OpenUtau ships with two wavtools, simple and convergence. There are also many third-party wavtools.

Installing Resamplers

After you install resampler, please switch to "CLASSIC" renderer to use the resampler you installed.

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

Macres provides a native macOS version. Put it into the resamplers folder of OpenUtau.

You can also use Windows resamplers with Wine: (tested on macOS 11.6)

  1. Install homebrew
  2. Install wine using following commands:
brew tap gcenx/wine
brew install --cask --no-quarantine wine-crossover
  1. Download "mac_additional.zip" from the release page.
  2. 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

Macres provides a native Linux version. Put it into the resamplers folder of OpenUtau.

For wrapping Windows resamplers into Linux, use this method:

  1. Install Wine
  2. Open the Resamplers folder (should be on ~/.local/share/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/bash
LANG="ja_JP.UTF8" wine "/absolute/path/to/your/resampler.exe" "${@,-1}"
  1. Change "/absolute/path/to/your/resampler.exe" to the path of the resampler.
  2. Restart OpenUtau.

Tested Resamplers and Directories

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

Windows

Resampler Author Resample Manifest Additional Notes
worldline StAkira Built into OpenUtau. Works on all platforms.
bkh01.exe Zteer
doppeltler32.exe Ameya doppeltler32.yaml
doppeltler64.exe Ameya doppeltler64.yaml
EFB-GT.exe Custom.Maid
EFB-PB.exe Custom.maid
f2resamp32.exe Ameya f2resamp32.yaml
f2resamp64.exe Ameya f2resamp64.yaml
fresamp11.exe Ameya
fresamp12.exe Ameya
fresamp14.exe Ameya
fresamp14omp.exe Ameya Ported to OpenMP with faster rendering speed than fresamp14.exe.
lessampler.exe YuzukiTsuru See additonal notes.
macres.exe titinko
model4.exe Ameya
moresampler.exe Kanru Hua moresampler.yaml See adjustments for compatibility.
phavoco.exe Ameya
phaavoco.exe Ameya
resampler.exe Ameya UTAU built-in resampler.
SpaceWorld_win64.exe LovelyA72 See adjustments for compatibility.
StrayCatRunner.exe Astel123457 StrayCatRunner.yaml
straycat-rs.exe UtaUtaUtau straycat-rs.yaml
StrayCat.py UtaUtaUtau StrayCat.yaml Deprecated in place of straycat-rs (above)
TIPS.exe ScientistB
tn_fnds.exe Zteer tn_fnds.yaml
UDB YuzukiTsuru UDB means UTAU Debug Engine.
vs4u.exe AckieSound
w4u.exe Zany w4u.yaml
WARP.exe Custom.Maid
wn4u.exe Zany See adjustments for compatibility.
young3.exe Zany

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

MacOS

Resampler Author Resample Manifest Additional Notes
worldline StAkira Built into OpenUtau. Works on all platforms.
macres titinko macres.yaml

Linux

Resampler Author Resample Manifest Additional Notes
worldline StAkira Built into OpenUtau. Works on all platforms.
macres titinko macres.yaml

Resampler Manifest

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.

image

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

Installing Wavtools

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.

Tested Wavtools and Directories

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

Wavtool Author Additonal Notes
simple StAkira Built into OpenUtau. Works on all platforms.
convergence StAkira Also built into OpenUtau. Uses phase compensation.
moresampler.exe Kanru Hua See adjustments for compatibility.
wavtool64 Ameya
wavtool4vcv nmasao