Musical Gestures Toolbox for Matlab
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 66 commits ahead of benlyyan:master.
Latest commit 6aafacf Jul 13, 2018
Failed to load latest commit information.
doc Adding documentation Jun 28, 2017
example New example file Feb 8, 2018
source-code updating help text Jul 13, 2018
MGT_MANUAL.pdf Add files via upload Aug 10, 2016 SC Feb 9, 2018
generate_documentation.m Adding documentation Jun 28, 2017

Musical Gestures Toolbox for Matlab

The Musical Gestures Toolbox (MGT) is a Matlab toolbox for analysing music-related body motion, using sets of audio, video and motion capture data as source material.


Important: The toolbox has mainly been tested on Windows, most recently with Matlab 2017a. A lot of things changed after Matlab 2015b, and we know that there are issues with running it on Mac and Linux. We are eager to get everything fixed, and we appreciate all help in finding (and fixing!) bugs.

  1. Ensure that you have the relevant Matlab dependencies installed:

    • Computer Vision System Toolbox
    • Image Processing Toolbox
  2. Install the dependencies:

  3. Add the files in the folder "source-code" to your Matlab path: under the "Home" section, click "set path". Click the "Add Folder" button and choose the "source-code" folder and finally click "save".

  4. Try out the m-files in the examples folder. There are some test files (audio, video, mocap) in the "example_data" folder.


The Musical Gestures Toolbox contains a set of functions for the analysis and visualization of video, audio, and mocap data. There are four categories of functions:

  • Data input and edit functions
  • Data preprocessing functions
  • Visualization functions
  • Middle and higher level feature extraction functions


There is a more or less complete introduction to the main features in the software carpentry workshop Quantitative Video analysis for Qualitative Research.


The toolbox builds on the Musical Gestures Toolbox for Max, which has been developed by alexarje since 2004, and parts of it is currently embedded in the Jamoma project.

The first version of the Musical Gestures Toolbox for Matlab was made by benlyyan as part of his M.Sc. thesis at the University of Oslo (Video analysis of music-related body motion in Matlab), and is currently maintained by the fourMs group.