Tony: a tool for melody transcription

h1. Reference

h2. User Interface

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

h2. 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/Cntrl-right to move the playhead by one note (Ctrl is Command on Mac)

h2. 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. (Ctrl is Command on Mac.)

h3. Select all

* Ctrl-A (Ctrl is Command on Mac.)

* Edit Menu -> Select All

h2. Correcting the pitch track

h3. Moving the pitch track by one octave

* select time interval in the Selection Strip, then press Ctrl-up or Ctrl-down. (Ctrl is Command on Mac.)

h3. Choosing alternative pitch track candidates

* select time interval in the Selection Strip, then press Ctrl-Enter to make alternative pitch tracks appear (in orange); Ctrl-up or Ctrl-down to choose; Ctrl-Enter to confirm choice. (Ctrl is Command on Mac.)

h1. Menus

h2. File Menu

h2. Edit Menu

h2. View Menu

h2. Analysis Menu

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.

h1. Toolbars

not covered (yet?)