OmniPitch beta: getting started
===============================

OmniPitch finds the notes in a recording of several voices (a choir, a vocal group, chords) and lets you
change each one on its own: its pitch, vibrato, drift, timing and level, the way Melodyne's polyphonic mode
does.

In Ableton Live (or any DAW)
----------------------------
1. Put OmniPitch on the audio track you want to edit, and open it.
2. Click "Transfer". It turns orange: "Armed".
3. Play the part of the song you want to edit. The audio comes into OmniPitch as it plays. Stop the song when
   you are done.
4. OmniPitch finds the notes (a few seconds), then gets each one ready for editing in the background. The bar
   along the top shows how far it has got.
5. Edit. From now on OmniPitch plays its own (edited) copy of that section in place of the track's audio.

One voice (a lead vocal, or singers in unison): choose "Solo" in the Detect menu before or after the
transfer. OmniPitch then follows a single line, and each note is that stretch of the recording itself, so
there is nothing to separate: notes are ready at once, and breaths and consonants between phrases are never
touched. Select all and use Correct pitch to tune the whole take.

Two controls appear next to Detect in Solo. "Notes" sets how readily a new note begins: slide it right for
trills and fast runs (every turn its own note), left for fewer, longer notes. It applies to the phrases of the
selected notes, or to everything when nothing is selected; notes it leaves as they were keep their edits, and
one Undo puts the old notes back. "Consonants" (on by default) leaves an s, a t or a breath inside a note's
stretch as recorded when the note is tuned, and at its own length when the note is made longer or shorter.

Change the song's tempo whenever you like: the edited section follows it and stays on the same beats. In
Melodyne's transfer mode, the audio stays at the old tempo.

Several tracks at once
----------------------
Put OmniPitch on each track you want to edit together (each voice of a choir, a lead and its backing vocals)
and transfer each one. Every OmniPitch window then shows all of them, each where its take sits in the song,
in the Tracks card beside the roll. Select and edit notes on any of them together: every tool, Correct pitch
and Tighten entries work across tracks, and each track's edits are played by its own OmniPitch. The eye in a
track's row hides its notes; clicking its name selects them; C colours the notes by track. Tighten entries >
Follow pulls the other tracks' entries to the track you choose, which stays as it is.
Some hosts run each plugin in a process of its own (for example Bitwig's plugin sandboxing, or Reaper's
"run as separate process"): there each window shows only its own track.

Editing
-------
Right mouse button, or hold Q: the tool wheel. Or press 1-9.
  1 Pitch       drag a note up or down. Cmd-drag for cents. Double-click snaps it to the nearest semitone.
  2 Modulation  drag to scale its vibrato, 0-200%.
  3 Drift       drag to scale its slow pitch wander.
  4 Split       click where a note should become two.
  5 Time        drag a note earlier or later. Drag one of its ends to make it longer or shorter at its
                pitch (a note that meets it there follows; Shift-drag moves that end alone). The Note card
                has Start and End to type; Option-Left/Right nudges ends by 10 ms, with Shift the starts.
  6 Volume      drag up or down. Double-click mutes it.
  7 Draw        drag along a row to add a note that was missed.
  8 Formant     drag up or down to move its formants (its timbre) and keep its pitch.
  9 Harmonics   drag up or down to make it brighter or darker. The Harmonics card beside the roll shows each
                harmonic: drag a bar to set that harmonic's level.
  0 Sibilants   drag up or down to make its s, t and breath sounds louder or softer, the sung part as it is.
                Double-click takes them out or puts them back. Best on Solo tracks.
Hold Cmd while dragging with any tool for fine steps.

Fades: with the Volume tool, drag a note's start or end sideways and it fades in from silence or out to
silence over that long. Transitions: where one note is sung straight into the next, drag the join sideways
with the Drift tool, and the pitch slides smoothly from one note to the other over that long (longer for a
portamento, shorter for a cleaner change; up to 1 s). Singers change notes in about 100-200 ms; much longer
sounds like a pitch bend. On a recording with reverb in it, the echo of the note as sung stays under the
slide. Both are also in the Note card: Fade in, Fade out, Transition.

Level: in the inspector, "Even out" evens out the loudness of the selected notes (or all of them): each
note's volume moves toward the typical loudness of its track, 100% making them alike. With several tracks,
"Each track to its own level" keeps a quiet voice quieter than a loud one; turn it off to bring every track to
one level. Muted notes stay muted; each release of the slider is one Undo step.

Fine tuning: in the Note card, "Fine" is the note's distance in cents from the nearest semitone. Click any value
there to type it (35c, -2, 442 Hz). "Snap" in the toolbar sets what a Pitch drag steps by (the key, semitones,
or nothing). "Tune to" in the Tuning card sets what in tune means: the voices around each note, or A4 at a
frequency you choose.

Zooming: pinch or Cmd-scroll zooms in on the pointer, time and pitch together. The sliders under the roll
zoom each alone, as do scrolling over the ruler (time) and Option-scroll (pitch).
Drag the waveform down to zoom in, up to zoom out. Hold Z and drag a box to zoom to it; Z alone zooms to the
selection, F fits everything, Shift-Z goes back to the view before. In the overview strip, drag the frame's
edges.

Click a note to hear it on its own. Option-drag duplicates it. Delete removes a wrong note; J joins notes.
"Correct pitch…" pulls every note (or the selected ones) toward the nearest semitone. E switches between the
original and the edited version, and Cmd-Z undoes.

Your edits are saved with the Live Set.

Known limits in this beta
-------------------------
- Notes are found on a mono mix of the track. Each edit goes equally into both channels, so a voice panned
  hard to one side is only partly moved.
- One section per plugin: Transfer again replaces it, and its edits.
- The editor gets notes ready more slowly than it will in a later version: allow about half the section's
  length.
- No export from inside the plugin yet. Bounce or freeze the track instead.

Feedback
--------
Send what you tried, what you expected, and the OmniPitch version shown in the editor's title to Blaine:
blainecowen.com
