annotate README.md @ 1735:db3d9ff6689e

Markdownise, add badges
author Chris Cannam
date Mon, 10 Jul 2017 17:34:06 +0100
parents README@2a53ed37351e
children fd37f59348f7
rev   line source
Chris@392 1
Chris@392 2 Sonic Visualiser
Chris@392 3 ================
Chris@392 4
Chris@1735 5 A program for viewing and analysing the contents of music audio files
Chris@1735 6 ---------------------------------------------------------------------
Chris@392 7
Chris@392 8 With Sonic Visualiser you can:
Chris@392 9
Chris@392 10 * Load audio files in various formats (WAV/AIFF, plus Ogg and mp3
Chris@392 11 if compiled in) and view their waveforms
Chris@392 12
Chris@392 13 * Look at audio visualisations such as spectrogram views, with
Chris@392 14 interactive adjustment of display parameters
Chris@392 15
Chris@392 16 * Annotate audio data by adding labelled time points and defining
Chris@392 17 segments, point values and curves
Chris@392 18
Chris@392 19 * Run feature-extraction plugins to calculate annotations
Chris@392 20 automatically, using algorithms such as beat trackers, pitch
Chris@848 21 detectors and so on (see http://vamp-plugins.org/)
Chris@392 22
Chris@392 23 * Import annotation data from various text formats and MIDI files
Chris@392 24
Chris@392 25 * Play back the original audio with synthesised annotations, taking
Chris@392 26 care to synchronise playback with the display position
Chris@392 27
Chris@392 28 * Slow down and speed up playback and loop segments of interest,
Chris@392 29 including seamless looping of complex non-contiguous areas
Chris@392 30
Chris@392 31 * Export annotations and audio selections to external files.
Chris@392 32
Chris@392 33 Sonic Visualiser can also be controlled remotely using the Open Sound
Chris@392 34 Control (OSC) protocol (if support is compiled in).
Chris@392 35
Chris@392 36
Chris@392 37 Credits
Chris@392 38 -------
Chris@392 39
Chris@392 40 Sonic Visualiser was developed at the Centre for Digital Music,
Chris@392 41 Queen Mary, University of London.
Chris@392 42
Chris@848 43 http://c4dm.eecs.qmul.ac.uk/
Chris@392 44
Chris@848 45 Sonic Visualiser was written by Chris Cannam with contributions from
Chris@848 46 Christian Landone, Mathieu Barthet, Dan Stowell, Jesus Corral Garcia,
Chris@848 47 Matthias Mauch, and Craig Sapp.
Chris@392 48
Chris@1465 49 Code copyright 2005-2007 Chris Cannam and copyright 2006-2017 Queen
Chris@392 50 Mary, University of London, except where indicated in the individual
Chris@392 51 source files.
Chris@392 52
Chris@1666 53 Russian translation provided by Alexandre Prokoudine, copyright
Chris@1666 54 2006-2017 Alexandre Prokoudine.
Chris@1666 55
Chris@1672 56 Czech translation provided by Pavel Fric, copyright 2010-2017 Pavel
Chris@1666 57 Fric.
Chris@1666 58
Chris@392 59 This work was partially funded by the European Commission through the
Chris@392 60 SIMAC project IST-FP6-507142 and the EASAIER project IST-FP6-033902.
Chris@392 61
Chris@392 62 This work was partially funded by the Arts and Humanities Research
Chris@392 63 Council through its Research Centre for the History and Analysis of
Chris@392 64 Recorded Music (CHARM).
Chris@392 65
Chris@392 66 This work was partially funded by the Engineering and Physical
Chris@848 67 Sciences Research Council through the OMRAS2 project EP/E017614/1, the
Chris@848 68 Musicology for the Masses project EP/I001832/1, and the Sound Software
Chris@848 69 project EP/H043101/1.
Chris@394 70
Chris@392 71 Sonic Visualiser is free software; you can redistribute it and/or modify
Chris@392 72 it under the terms of the GNU General Public License as published by
Chris@392 73 the Free Software Foundation; either version 2 of the License, or (at
Chris@392 74 your option) any later version. See the file COPYING included with
Chris@392 75 this distribution for more information.
Chris@392 76
Chris@392 77 Sonic Visualiser may also make use of the following libraries:
Chris@392 78
Chris@1672 79 * Qt5 -- Copyright The Qt Company, distributed under the LGPL
Chris@549 80 * JACK -- Copyright Paul Davis, Jack O'Quin et al, under the LGPL
Chris@392 81 * PortAudio -- Copyright Ross Bencina, Phil Burk et al, BSD license
Chris@392 82 * Ogg decoder -- Copyright CSIRO Australia, BSD license
Chris@392 83 * MAD mp3 decoder -- Copyright Underbit Technologies Inc, GPL
Chris@1672 84 * libsamplerate -- Copyright Erik de Castro Lopo, BSD license
Chris@392 85 * libsndfile -- Copyright Erik de Castro Lopo, LGPL
Chris@392 86 * FFTW3 -- Copyright Matteo Frigo and MIT, GPL
Chris@1672 87 * Rubber Band -- Copyright Particular Programs Ltd, GPL
Chris@549 88 * Vamp plugin SDK -- Copyright Chris Cannam and QMUL, BSD license
Chris@392 89 * LADSPA plugin SDK -- Copyright Richard Furse et al, LGPL
Chris@392 90 * RtMIDI -- Copyright Gary P. Scavone, BSD license
Chris@1672 91 * Dataquay -- Copyright Particular Programs Ltd, BSD license
Chris@549 92 * Sord and Serd -- Copyright David Robillard, BSD license
Chris@549 93 * Redland -- Copyright Dave Beckett and the University of Bristol, LGPL/Apache license
Chris@392 94 * liblo OSC library -- Copyright Steve Harris, GPL
Chris@1672 95 * Cap'n Proto -- Copyright Sandstorm Development Group, Inc, BSD license
Chris@392 96
Chris@392 97 (Some distributions of Sonic Visualiser may have one or more of these
Chris@392 98 libraries statically linked.) Many thanks to their authors.
Chris@392 99
Chris@392 100
Chris@392 101 Compiling Sonic Visualiser
Chris@392 102 --------------------------
Chris@392 103
Chris@392 104 If you are planning to compile Sonic Visualiser from source code,
Chris@392 105 please read the file INSTALL.txt.
Chris@392 106
Chris@1735 107 | Linux and macOS CI Build Status | [![Build Status](https://travis-ci.org/sonic-visualiser/sonic-visualiser.svg?branch=master)](https://travis-ci.org/sonic-visualiser/sonic-visualiser) |
Chris@1735 108 | Windows CI Build Status | [![Build status](https://ci.appveyor.com/api/projects/status/26pygienkigw39p7?svg=true)](https://ci.appveyor.com/project/cannam/sonic-visualiser) |
Chris@1735 109
Chris@392 110
Chris@392 111 More information
Chris@392 112 ----------------
Chris@392 113
Chris@392 114 For more information about Sonic Visualiser, please go to
Chris@392 115
Chris@392 116 http://www.sonicvisualiser.org/
Chris@392 117