Sonic Visualiser

h1. Library Edition

Sonic Visualiser is an application for viewing and analysing the contents of music audio files. The Library edition (release 1.9) provides adaptations for the use of Sonic Visualiser at the British Library and new features tailored for musicologists:

- All of the features of the full Sonic Visualiser are provided, except that audio files cannot be saved from it ("Kiosk Edition").

- Two operating modes are available:

* *minimal mode* with an easy-to-use interface offering pure playback functionality (_closed listening practice_);

* *full mode* where visualisations (e.g. spectrograms) and audio feature extractions are possible (_multimodal listening practice_).

- Session templates can be used to load/store the layout of the user interface (waveform, spectrogram, note onsets, etc.) and user parameters.

- Pitch identification can be performed more easily, by comparing against synthesised notes played on the piano keyboard scale in the spectrum and melodic spectrogram representations.

"Vamp plugins":http://vamp-plugins.org/ (add-ons which extract descriptive information from audio data) can be used jointly with Sonic Visualiser.

h3. How to Install Vamp plugins

Vamp plugins can be downloaded from "vamp-plugins.org/download.html":http://vamp-plugins.org/download.html .

A Vamp plugin set consists of a single dynamic library file with the file extension .dll, .dylib, or .so (depending on your platform) plus optionally a category file with .cat extension and an RDF description file with .ttl or .n3 extension.

To install a plugin set, just copy the plugin's library file and any supplied category or RDF files into your system or personal Vamp plugin location.

The plugin file extension and the location to copy into depend on your platform:

||File extension|System plugin folder|Personal plugin folder|

|Linux or other Unix|..so|/usr/local/lib/vamp|$HOME/vamp|

|Mac OSX|..dylib|/Library/Audio/Plug-Ins/Vamp|$HOME/Library/Audio/Plug-Ins/Vamp|

|Windows (32-bit)|..dll|C:\Program Files\Vamp Plugins||	 

|Windows (64-bit)|..dll|C:\Program Files (x86)\Vamp Plugins||

(You can alternatively set the VAMP_PATH environment variable to list the locations a host should look in for Vamp plugins. VAMP_PATH should contain a semicolon-separated (on Windows) or colon-separated (OS/X, Linux) list of paths. If it is set, it will completely override the standard locations listed above.)

h3. Documentation and Tutorials

The "reference manual of Sonic Visualiser is available online here":http://www.sonicvisualiser.org/doc/reference/1.9/en/index.html .

Further documentation and tutorials can be found on the main "Sonic Visualiser website":http://www.sonicvisualiser.org/documentation.html, and on that of the "Centre for the History and Analysis of Recorded Music (CHARM)":http://www.charm.kcl.ac.uk/analysing/p9_0_1.html at King's College London.

h3. Acknowledgements

Sonic Visualiser Library Edition has been developed within the "Musicology for the masses project":http://www.elec.qmul.ac.uk/digitalmusic/m4m/ at Queen Mary University of London (EPSRC Grant "EP/I001832/1":http://gow.epsrc.ac.uk/ViewGrant.ASPx?Grant=EP/I001832/1).

h3. Attached files