Wiki » History » Version 30

Matthias Mauch, 2014-06-16 04:20 PM

1 23 Matthias Mauch
{{toc}}
2 1 Matthias Mauch
3 24 Matthias Mauch
h1. Tony Introduction
4 24 Matthias Mauch
5 19 Matthias Mauch
Tony is a program for computer-aided melody annotation. It has a graphical interface based on the  "SV libraries":/projects/sv and uses the "pYIN":/projects/pyin Vamp plugin to extract pitch track and notes from monophonic audio.
6 19 Matthias Mauch
7 19 Matthias Mauch
h2. Getting Started
8 19 Matthias Mauch
9 19 Matthias Mauch
h3. Installation
10 19 Matthias Mauch
11 19 Matthias Mauch
We provide ready-to-use software builds for Windows and Mac OSX on the "Downloads page":/projects/tony/files. On Windows you can simply download and execute the installer (.msi), and on OSX you download the disk image (.dmg), mount it and drag "Tony" into your Applications folder.
12 1 Matthias Mauch
13 24 Matthias Mauch
For Linux users with ample compilation experience we also provide the source code, available on the "Downloads page":/projects/tony/files.
14 24 Matthias Mauch
15 1 Matthias Mauch
h3. User Interface
16 1 Matthias Mauch
17 24 Matthias Mauch
Below is an annotated screen shot of the Tony user interface. We will refer to these elements in the paragraphs below.
18 24 Matthias Mauch
19 26 Matthias Mauch
!/attachments/download/1114/Tony_User_Interface.png!
20 24 Matthias Mauch
21 29 Matthias Mauch
h3. Tutorial 1: From Zero to Annotating Notes in an Audio File
22 24 Matthias Mauch
23 24 Matthias Mauch
This mini-tutorial walks you through the complete process of using Tony to load an audio file, annotate the notes in it and export the notes to a .csv (comma-separated values) file.
24 24 Matthias Mauch
25 24 Matthias Mauch
# Start the _Tony_ program by double-clicking (or whatever you routinely do to open programs).
26 1 Matthias Mauch
# Open an audio file of your choice. Mind that _Tony_ only deals with single melodies *without* accompaniment, so choose a little bit of accompanied solo singing or the like.
27 1 Matthias Mauch
# Upon opening of the file, _Tony_ will automatically analyse the file using "pYin":/projects/pyin pitch and note extraction, and pitches and notes should appear. _If no pitch track and notes occur, please see Analysis Settings and Visualisation, below._
28 27 Matthias Mauch
# Get comfortable moving around and playback... a few suggestions:
29 27 Matthias Mauch
#* play audio by clicking on the play button in the top toolbar, or simply by pressing the space bar on your keyboard
30 27 Matthias Mauch
#* use the Navigate tool to move around in the audio file: simply left-click and drag in the main pane
31 27 Matthias Mauch
#* try navigating with the keyboard, too. The left and right cursor keys will move the play head
32 27 Matthias Mauch
# Get comfortable with different visualisations and sonifications:
33 28 Matthias Mauch
#* try switching (toggling) different visualisations on and off in the bottom toolbar: waveform, pitch track (the black line), note track (the blue boxes), spectrogram (the gray-scale background)
34 1 Matthias Mauch
#* try switching on the pitch track sonification (sound representation) by toggling the loudspeaker symbol next to the pitch track symbol in the bottom toolbar -- you should be able to hear a funny sine-like tone at the same pitch as the original audio when sonification is on.
35 1 Matthias Mauch
#* turn off pitch track sonification, and turn on note track sonification -- what's the difference?
36 28 Matthias Mauch
#* you can switch the original audio on and off too (next to the waveform)
37 28 Matthias Mauch
#* what effect does the pan wheel (the one with the green circle) have on sonification? -- you can choose where in the stereo image to sonify the sounds: left, right, or anywhere in between.
38 28 Matthias Mauch
# Note correction. Tony will have provided you with a first, dirty note track which you can correct -- *that's what _Tony_ is all about*.
39 28 Matthias Mauch
#* Make sure you can see the notes. If not, turn note visualisation on.
40 24 Matthias Mauch
41 30 Matthias Mauch
h2. Tony User Documentation
42 1 Matthias Mauch
43 30 Matthias Mauch
h3. Analysis Menu
44 30 Matthias Mauch
45 30 Matthias Mauch
The "Analysis" menu allows you to re-analyse the audio for pitches and notes and to choose some analysis settings.
46 30 Matthias Mauch
47 30 Matthias Mauch
* *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.
48 30 Matthias Mauch
* *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.
49 30 Matthias Mauch
* *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.
50 30 Matthias Mauch
* *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.
51 25 Matthias Mauch
52 25 Matthias Mauch
h3. Sonification
53 19 Matthias Mauch
54 19 Matthias Mauch
h2. Nerdy matters
55 18 Matthias Mauch
56 18 Matthias Mauch
[[Development Wiki]]