QPitch Documentation

1.0.1

News

  • 08-11-2007: QPitch 1.0 released as source code and binaries for Linux, Mac Os X and Windows.
  • 02-08-2008: Added a simple installation guide.
  • 13-08-2008: Build tools switched to CMake and QPitch 1.0.1 released as source code (contributed by Nico Schlömer)

QPitch 1.0

Download

Source Code Binaries

About QPitch 1.0.1

QPitch is a program to tune a musical instrument using your computer and its microphone or line-in input. It is designed to be completely cross-platform and works on Linux, Mac and Windows platforms.

QPitch 1.0.1 is an offspring of K3Guitune 1.0. The layout of the GUI and the pitch detection algorithm are quite similar to the original ones, however the application has been rewritten almost from scratch to take advantage of the new features of Qt4 and to use the cross-platform PortAudio library. The FFT is performed using the FFTW library.

The pitch detection algorithm is based on finding the first peak in the autocorrelation of the input signal. The method is quite reliable (even if a peak may also occur at sub-harmonics or harmonics leading to an erroneous pitch detection). The fundamental frequency used as a reference for pitch detection can be configured according to the user preferences.

The estimated pitch is displayed on a note scale graphic, while the input signal and the autocorrelation function are displayed using an oscilloscope-like plot.

The documentation (and even this site) is generated with Doxygen.

Compilation from source

The compilation of QPitch 1.0 from source requires the following libraries

  • Qt4 (version >= 4.2.0)
  • PortAudio (version >= pa_stable_v19_061121)
  • FFTW (version >= 3.1.0)

There are basically two ways to compile QPitch (with the first one preferred)

Compilation using CMake

The first option is based on the CMake utility to create a suitable Makefile. Any version of CMake grater than 2.4 should be enough

$ tar -xjvf qpitch-1.0.1.tar.bz2
$ cd qpitch-1.0.1
$ mkdir build
$ cd build
$ cmake ..
$ make

Compilation using qmake

The second option is based on the qmake utility shipped with the Qt4 library to create a suitable Makefile.

$ tar -xjvf qpitch-1.0.1.tar.bz2
$ cd qpitch-1.0.1/src
$ qmake qpitch.pro
$ make

If the required libraries are not installed system wide, you may have to adjust the qpitch.pro file in order to include the correct path and run qmake to update the Makefile.


Generated on Thu Nov 8 21:16:55 2007 for QPitch by Doxygen 1.5.3 - Copyright (C) William Spinelli