Tony: a tool for melody transcription

h1. Reference (v0.6)

{{toc}}

h2. 1. User Interface

!/attachments/download/1115/Tony_User_Interface.png!

h2. 2. Navigation

Several ways of navigating _Tony_ are available

* click and drag in the Main Pane to move the visible area

* click in the Selection Strip to move the playhead to the time you clicked on

* press left and right arrows to move the playhead forward and backward, respectively

* press Ctrl-left/Ctrl-right to move the playhead by one note (Mac: ⌘-left/⌘-right)

h2. 3. Selection

Only time intervals can be selected. 

h3. Selecting an arbitrary time interval

* click into Selection Strip and drag selects the time interval you drag across.

* Shift-click and drag in the Main Pane, while used for pitch track correction, will also select the time interval you drag across.

h3. Selecting an interval coinciding with notes

* double-click in Selection Strip selects the time interval covered by the current note.

* Shift-Ctrl-left and Shift-Ctrl-right move the playhead by one note and select the time interval. (Mac: Shift-⌘-left and Shift-⌘-right)

h3. Select all

* Ctrl-A (Mac: ⌘-A)

* Edit Menu -> Select All

h2. 4. Correcting the pitch track

h3. Removing pitch track

* Select time interval in which you want to delete pitches; then either 

** press Ctrl-Backspace (Mac: ⌘-Backspace) or

** Edit -> Remove Pitches

h3. Moving the pitch track by one octave

* select time interval, then press Ctrl-up or Ctrl-down. (Mac: ⌘-up/⌘-down)

h3. Choosing alternative pitch track candidates

* Intelligent alternative candidates

*# select time interval in the Selection Strip

*# press Ctrl-Enter to make alternative orange pitch tracks appear (Mac: ⌘-Enter)

*# Ctrl-up or Ctrl-down to cycle through them and choose  (Mac: ⌘-up/⌘-down)

*# Ctrl-Enter to confirm choice. (Mac: ⌘-Enter), press Escape to discard.

* User-range alternative candidates

*# use Shift-click-drag to indicate a time/pitch area for the new pitch track

*# Ctrl-Enter to make alternative pitch track appear (Mac: ⌘-Enter)

*# Ctrl-Enter to confirm choice. (Mac: ⌘-Enter), press Escape to discard.

h3. Adding pitch track

_see Choosing alternative pitch track candidates_

h2. 5. Correcting notes

h3. Splitting

Two options for splitting exist.

* select the Edit Tool in the upper toolbar, then click the bottom of a note

* move the play head to the desired splitting position, then either

** press / (slash) or

** Edit -> Split Note

h3. Merging

* select a time region with the notes you want to merge, then either

** press \ (backslash) or

** Edit -> Merge Notes

h3. Deleting

Two options for deleting exist.

* select the Edit Tool in the upper toolbar, then Shift-click the bottom of a note.

* select the time region with the notes you want to delete, then either

** press Backspace or

** Edit -> Delete Note

h3. Creating

To create a new note do either of the following:

* select the Edit Tool in the upper toolbar, then double-click on a time region not occupied by a note

* select a time region, then either

** press = (equal sign)

** Edit -> Form Note From Selection

h3. Correcting the note pitch

At present, the notes' pitch adapts to the pitch track, so any pitch correction is done via the pitch track.

h2. 6. Analysis Menu and Settings

The "Analysis" menu allows you to re-analyse the audio for pitches and notes and to choose some analysis settings.

* *Analyse Now!* will run "pYin":/projects/pyin to extract pitches and notes and replaces all currently annotated pitches and notes. While you can undo this, you might still want to consider carefully whether to use this option if you have put a lot of work into annotating notes or pitches.

* *Auto-Analyse New Audio*. _Tony_ will, by default, analyse any new audio that you load. If you do not want this behaviour, you can de-select it here.

* *Unbiased Timing (slow)*. By default the "pYin":/projects/pyin analysis is based on ordinary YIN, which has a funky asymmetric window and introduces a small timing bias of up to 5ms. If you need zero time bias, then tick this item. This will be much slower, since this option cannot use the Fast Fourier Transform.

* *Penalise Soft Pitches*: this option is on by default and reduces the impact of very low-amplitude content, effectively suppressing some spurious pitches. If you don't want this, untick.