annotate README @ 845:da43c4461f9e

Respond tidily to user cancellation during download, instead of going on to attempt to load the nonexistent file as a non-audio format

Sonic Visualiser
================

Sonic Visualiser is a program for viewing and analysing the contents
of music audio files.

With Sonic Visualiser you can:

 * Load audio files in various formats (WAV/AIFF, plus Ogg and mp3
if compiled in) and view their waveforms
 
 * Look at audio visualisations such as spectrogram views, with
interactive adjustment of display parameters

 * Annotate audio data by adding labelled time points and defining
segments, point values and curves

 * Run feature-extraction plugins to calculate annotations
automatically, using algorithms such as beat trackers, pitch
detectors and so on

 * Import annotation data from various text formats and MIDI files

 * Play back the original audio with synthesised annotations, taking
care to synchronise playback with the display position

 * Slow down and speed up playback and loop segments of interest,
including seamless looping of complex non-contiguous areas

 * Export annotations and audio selections to external files.

Sonic Visualiser can also be controlled remotely using the Open Sound
Control (OSC) protocol (if support is compiled in).


Credits
-------

Sonic Visualiser was developed at the Centre for Digital Music,
Queen Mary, University of London.

  http://www.elec.qmul.ac.uk/digitalmusic/

The main program is by Chris Cannam, with additional DSP and program
design work by Christian Landone.  Thanks also to Craig Sapp for his
suggestions and useful feedback.

Code copyright 2005-2007 Chris Cannam and copyright 2006-2013 Queen
Mary, University of London, except where indicated in the individual
source files.

This work was partially funded by the European Commission through the
SIMAC project IST-FP6-507142 and the EASAIER project IST-FP6-033902.

This work was partially funded by the Arts and Humanities Research
Council through its Research Centre for the History and Analysis of
Recorded Music (CHARM).

This work was partially funded by the Engineering and Physical
Sciences Research Council through the OMRAS2 project EP/E017614/1.

This work was partially funded by the Engineering and Physical
Sciences Research Council through the Musicology for the Masses
project EP/I001832/1.

Sonic Visualiser is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.  See the file COPYING included with
this distribution for more information.

Sonic Visualiser may also make use of the following libraries:

 * Qt5 -- Copyright Digia Oyj, distributed under the LGPL
 * JACK -- Copyright Paul Davis, Jack O'Quin et al, under the LGPL
 * PortAudio -- Copyright Ross Bencina, Phil Burk et al, BSD license
 * Ogg decoder -- Copyright CSIRO Australia, BSD license
 * MAD mp3 decoder -- Copyright Underbit Technologies Inc, GPL
 * libsamplerate -- Copyright Erik de Castro Lopo, GPL
 * libsndfile -- Copyright Erik de Castro Lopo, LGPL
 * FFTW3 -- Copyright Matteo Frigo and MIT, GPL
 * Rubber Band -- Copyright Chris Cannam, GPL
 * Vamp plugin SDK -- Copyright Chris Cannam and QMUL, BSD license
 * LADSPA plugin SDK -- Copyright Richard Furse et al, LGPL
 * RtMIDI -- Copyright Gary P. Scavone, BSD license
 * Dataquay -- Copyright Breakfast Quay, BSD license
 * Sord and Serd -- Copyright David Robillard, BSD license
 * Redland -- Copyright Dave Beckett and the University of Bristol, LGPL/Apache license
 * liblo OSC library -- Copyright Steve Harris, GPL

(Some distributions of Sonic Visualiser may have one or more of these
libraries statically linked.)  Many thanks to their authors.


Compiling Sonic Visualiser
--------------------------

If you are planning to compile Sonic Visualiser from source code,
please read the file INSTALL.txt.


More information
----------------

For more information about Sonic Visualiser, please go to

  http://www.sonicvisualiser.org/