Expressive Means Vamp Plugins

Vamp plugins for analysis of articulation, vibrato, and portamento in audio recordings of musical performances, with a primary focus on bowed stringed instruments.

• Method by Frithjof Vollmer, Stuttgart University of Music and the Performing Arts (Germany)
• Code by Chris Cannam, Particular Programs Ltd (London, UK)
• Makes use of "pYIN" by Matthias Mauch and of Tilo Haehnel's "vibratoanalyse.R" method

See the reference manual for comprehensive documentation.

To install from a pre-built package

Installation is the same as for other individual Vamp plugin libraries:

• On Windows, copy expressive-means.dll, expressive-means.cat, and expressive-means.n3 to the folder C:\Program Files\Vamp Plugins\. (Note that only 64-bit versions of Windows and 64-bit plugin hosts are supported)

• On a Mac, copy expressive-means.dylib, expressive-means.cat, and expressive-means.n3 to the folder /Library/Audio/Plug-Ins/Vamp or $HOME/Library/Audio/Plug-Ins/Vamp

• On Linux, copy expressive-means.so, expressive-means.cat, and expressive-means.n3 to the folder /usr/local/lib/vamp or $HOME/vamp

In each case, if the destination folder doesn't already exist, create it as a new folder first.

See the general Vamp How to Install guide for more information.

To build from source code

Prerequisites

These dependencies are needed to build the plugins from a source release:

• C++ compiler and typical build tools

• The Meson build system

• The Boost Math library (used by pYIN)

These further dependencies are needed to build the plugins from a clone of the source repository:

• Both Git and Mercurial (the latter for pYIN code)

• Any Standard ML compiler supported by Repoint (Poly/ML, SML/NJ, or, on non-Windows platforms only, MLton)

None of these are required in order to use a plugin once it has been built.

Linux

Install the above-listed prerequisites using the distro package manager, e.g. for Ubuntu try

$ sudo apt-get install -y build-essential git mercurial mlton meson ninja-build libboost-math-dev

Then if you are in a clone of the repository, first run

$ ./repoint install

Then in all cases run

$ meson setup build
$ ninja -C build

Then either ninja -C build install, or try something like

$ VAMP_PATH=./build sonic-visualiser

macOS

This is easiest if you use Homebrew. You also need the Xcode command-line tools.

$ brew install mercurial polyml meson ninja boost

Then if you are in a clone of the repository, first run

$ ./repoint install

Then in all cases run

$ meson setup build
$ ninja -C build

Then try something like

$ VAMP_PATH=./build sonic-visualiser

Instructions for other platforms to follow.

Automated continuous integration builds

• Linux CI build:
• macOS CI build:

Note that each of these builds produces a compiled plugin as an artifact, and you can download them for testing if you wish. To do so, click on the build badge above for the platform you want, then on the run you want to obtain the build from (typically the most recent one, listed at the top of that page), then scroll down to Artifacts and click on the one called plugin. Unzip the downloaded archive and copy its contents into your Vamp Plugins folder.

Licence

Expressive Means is distributed under the GNU General Public License (GPL). You can redistribute it and/or modify it under the terms of the GPL; either version 2 of the License, or (at your option) any later version. See the file COPYING for more information.