harmony-analyser

Back to main page

Table of contents

  1. Introduction
  2. JHarmonyAnalyser library documentation
    1. Installation
    2. Chord Analyser reference
    3. Chroma Analyser reference
  3. harmony-analyser tools documentation
    1. Installation
    2. Chord Transition Tool
    3. Audio Analysis Tool
    4. Visualization Tool
  4. List of publications
  5. Contact information

1. Introduction

harmony-analyser is a set of visual tools for music harmony analysis of WAV/MIDI input, powered by JHarmonyAnalyser library. The application was developed 2013-2016 as a joint Master's thesis & PhD thesis project (Comenius University in Bratislava, Charles University in Prague, with the help of LaBRI Université Bordeaux 1) by Ladislav Maršík [contact author].

Documentation has two parts:

  1. JHarmonyAnalyser library documentation explains the used models of music theory, chord and chroma distances.
  2. harmony-analyser tools documentation explains the user interface of available tools on harmony-analyser.org

2. JHarmonyAnalyser library documentation

For version: 1.2

2.1. Installation

Download and unpack the source tarball from the library releases page. Optionally, download the library in the form of JAR file, importing it to your project.

2.2 Chord Analyser reference

Chord Analyser is a joint name for the models available under chord_analyser Java package. Explanation of the models follow:

2.3. Chroma Analyser reference

Chroma Analyser is a joint name for the models available under chroma_analyser Java package. Explanation of the models follow:

3. harmony-analyser tools documentation

For version: 1.2

3.1 Installation

Download the executable JAR file from releases page. Please note that JRE 8 or higher needs to be installed on your machine, and the selection of Vamp plugins needs to be installed locally:

3.2 Chord Transition Tool

Make sure that a MIDI input device is connected to your machine. Chord Transition Tool works with MIDI devices connected to the MIDI IN port on your soundcard, or USB port. If you don't have a MIDI input device, you can still use a virtual MIDI keyboard such as vkeybd for Linux (make sure that the raw MIDI ports are available when using virtual keyboards) or just use the text input in Chord transition tool. By hitting capture you can record two chords. Alternative way is to insert the chord in the text feel in absolute format (e.g. C3 E3 G3) or relative format (e.g. C E G). The tool will calculate the chord complexity of both chords and the transition complexity in between them.


3.3 Audio Analysis Tool

Choose the folder to analyse (you should have your WAV files prepared in this folder). To see the available plugins and their settings, click button "List plugins". Proceed by clicking any of the available analysis buttons.


3.4 Visualization Tool

Choose the full path for the WAV file to analyse. Choose the desired visualizations in the drop-down menus. After hitting the analyse button, the visulizations will render. If the analysis outputs have already been created, the analysis will not be overriden. Instead, the files will be read from hard-drive, and the visualization displayed based on the information found.


4. List of publications

Find out more information about our software in the following list of scientific papers:

5. Contact information

Reach us at: