Getting Started - stakira/OpenUtau GitHub Wiki

About OpenUtau

Please see Tutorials for an overview of OpenUtau and how it differs from conventional UTAU.

Install

For installing the OpenUtau Editor, voicebanks, and resampler, please see the Install page.

Projects

Creating projects

When you start OpenUtau, you have a new, blank project.
You can also start a new project from File > New.

Tempo and Time Signature

Click on the tempo or time signature in the top left corner to edit it.

Time signatures can have any positive whole number on top, and any power of 2 on the bottom.
Tempos can be any number, including decimals.

You can also change the tempo and time signature by right-clicking the bar/measure labels.

Expressions

Expressions allow you to change parameters note-by-note, similar to flags in UTAU. Expressions are saved per-project. To edit expression settings, go to Tools > Expressions.

Default expressions

Name	Abbreviation	Purpose	Range	Default
Velocity	VEL	Consonant velocity (stretch/shorten preutterance)	0 - 200	100
Volume	VOL	Note volume	0 - 200	100
Attack	ATK	Envelope starting volume	0 - 200	100
Decay	DEC	Envelope ending volume	0 - 100	0
Voice color	CLR	Utilizes voicebank appends/colors	No range, options	Blank
Resampler engine	ENG	Change resamplers on the fly	No range, options	, worldline64.exe
Gender	GEN	g flag (formant shift)	-100 - 100	0
Breath	BRE	B flag (breathiness)	0 - 100	0
Lowpass	LPF	H flag (low pass filter)	0 - 100	0
Modulation	MOD	Note modulation from original pitch	0 - 100	0
Alternate	ALT	Alternate aliasing for duplicates in oto.ini	0 - 16	0
Tone shift	SHFT	Allows for selecting pitch alias	-36 - 36	0

Adding expressions

Use the + and - buttons in the lower left corner to add and remove expressions. Some expressions cannot be removed. There are two types of expressions, numerical expressions and fixed options.

For numerical expressions fill out the name, abbreviation, resampler flag, minimum, maximum, and default value. The resampler flag must be a single flag by itself without any numbers. If you want the whole project to have a certain value (eg. Mt+20) please put the number in the Default box.

For options, fill out the name, abbreviation, checkbox, and option values. This is for flags that don't take any numbers, like for toggling between stretching and looping.

Opening projects

Open projects using File > Open, or Ctrl+O.
You can open .ustx, .ust, or .vsqx files.

Saving projects

OpenUtau projects are saved as .ustx files.
Save the current project using File > Save, or Ctrl+S.
Save the project as a new file using File > Save As.

After saving the project, you can also export all tracks as separate .ust files using File > Export Project > Export Ust Files. The files will be saved in an Export folder next to the original .ustx file.

Exporting audio

After saving the project, use File > Export Audio > Export wav Files to render all tracks as separate .wav files. The files will be saved in an Export folder next to the original .ustx file.

Tracks

Creating tracks

Click the + icon in the left panel to create a new track.

Importing tracks

Imported tracks will be added to the current project under all of your existing tracks.

You can import tracks from .ustx, .ust, and .vsqx files using File > Import Tracks.
You can import audio from .wav, .mp3, .ogg, and .flac files using File > Import Audio.
You can import tracks MIDI using File > Import MIDI.

Editing tracks

Select a singer from the menu in the track header.

You can optionally select a phonemizer, which will automatically convert note lyrics into a form the voicebank can play. For more details, please check Phonemizers.

The M in the right corner of the track header mutes the track, while the S solos the track. The settings cog in the lower right allows you to select a Resampler and Wavtool.

You are also able to click and drag the volume slider to adjust the volume of the track. Right click to reset this slider to +00.0.

Click in the track area to create a new part. You can drag the part to move it around, drag the end to change the length, and right click to delete parts.

The right click dialog also allows you to rename a part.

Double click on a part to open the note editor.

Navigation

Click on the bar/measure labels to move the playback cursor, and press space to start/stop playing.

To scroll vertically, scroll normally.

To scroll horizontally, you can hold shift and scroll, or hover your cursor over the horizontal scroll bar and scroll.

To zoom horizontally, hover your cursor over the bar/measure labels and scroll.

To zoom vertically, hover your cursor over the vertical zoom icon and scroll.

Transcribe audio to notes

OpenUtau can autometically transcribe wave parts to note parts.

Before using, please download the model from here and install it using "Tools → Install Dependency (.oudep)"

Right click on a wave part and click "Transcribe audio to create a note part". The transcription process takes about 1 minute.

The model is trained on clean solo vocal, so it works best on this kind of audio. It may not work well on music with instrumental or with heavy reverberation.

Notes

Toggle tips using the question mark button or pressing T on the keyboard.

Navigation

Scroll, zoom, and playback function the same way as the track editor.

Basic note editing

There are two note creation modes:

Pen Tool

Click to create notes, Right click to bring up an options menu. This is a good mode for tuning and intensive lyric editing due to the ease of access to batch editing tools.

Pen Tool +

Click to create notes, and right click to delete notes. This is a good mode for composition and UST creation, due to its speed.

Double click to start inputting lyric, tab to finish and switch to next note.

Drag notes to move them around. Drag the end to change the length. Hold Alt while adjusting length to resize the following note.

Hold Ctrl and click and drag to select multiple notes.

Use the arrow keys to move selected notes up/down by 1 semitone, and Ctrl + arrow keys to move notes up/down by 1 octave.

By default, notes and lengths will snap to the nearest 16th note. To toggle snap, click on the snap icon in the top left, or press P on your keyboard.

Slur notes

To input slur note (a syllable that sings across multiple musical notes), input the word in the first note and input + in following notes.

For multisyllable languages such as English, use + to distribute a new syllable and use +~ to extend the current syllable.

Batch Edits, Transformers and Legacy Plugins

These can be accessed via the text options along the top of the Piano Roll view.

These are applied to the selected notes (or to the whole part if none are selected) at once.
Lyric Transformers are used for simple 1-to-1 lyric conversions.

Legacy Plugins provide limited support for UTAU plugins. To add a plugin, copy the folder into the Plugins folder of OpenUtau. Not all plugins will function normally or completely. Some popular plugins (eg. VCV conversion, CVVC conversion) are handled by track phonemizers.

Edit expressions

Use the arrow by the expressions to select which one you want to edit.

The gear icon will allow you to view the expression settings for the whole project.

Click to set a value, and right click to reset it to the project default.

VEL (velocity)

This corresponds to UTAU's Consonant Velocity. This affects the length of the fixed region of the OTO, which is the beginning of the note/phoneme.

VOL (volume)

This raises or lowers the overall volume of the note/phoneme.

ATK (attack)

This raises or lowers the volume of the beginning of the note/phoneme.

DEC (decay)

This lowers the volume of the rest of the note/phoneme.

ENG (Resampler Engine)

Selects resampler engine used to render this phoneme. If value is "", the engine selected in Preferences is used.

MOD (modulation)

This determines how much the pitch is flattened from the original recording. By default this is 0, or completely flat.

Options Flags (Non-Numerical Flags)

Add a flag. Change its type to "Options" and set "Option Values" to ",e". You will be able to use an expression to add nothing or "e" to resampler flags.

Other expressions

All other expressions are like flags in UTAU.

Edit pitchbends

You can show/hide pitchbends using the pitchbend icon in the top left, or by pressing I on your keyboard. Hidden pitchbends will still be applied to the notes.

Click on the pitchbend to create new points. Drag the point to move it around.

Right click on the pitchbend to pick a shape.

Right click on a point for the option to delete it.

Edit vibrato

You can show/hide vibrato using the vibrato icon in the top left, or by pressing U on your keyboard. Hidden vibrato will still be applied to notes.

Click on the vibrato icon below a note to toggle it on or off.

You can adjust the vibrato starting point, fade-in length, depth, fade-out length, frequency, and phase.

Edit phoneme envelopes

You can show/hide envelopes using the envelope icon in the top left, or by pressing O on your keyboard. Phonemization and envelope edits are applied even when hidden.

Drag the pink lines to adjust the timing of phonemes within notes. Right click to reset the timing. You can right click and drag to reset multiple phonemes at once.

Drag the bottom left corner to adjust the starting point of the envelope. Right click on the circle to reset.

Drag the top left corner to adjust the overlap amount. Right click on the circle to reset.

Beta version

OpenUtau provides two release channels: stable and beta. Sometimes you may want to use the beta version to try out new features, or because you encountered a bug in stable version.

To switch to the beta version, go to "Tools → Preferences", turn on "Beta", and check for update.

If the method above doesn't work, you can also manually download the latest beta version from https://github.com/stakira/OpenUtau/releases