Musical Instrument Tuner
C Makefile CSS JavaScript C++ HTML Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
gui
img
lv2ttl
modgui
robtk @ e0249a2
src
.gitattributes
.gitignore
.gitmodules
COPYING
Makefile
Makefile.git
README.md
git2lv2.mk
x42-tuna.1

README.md

Tuna.LV2

An musical instrument tuner with strobe characteristics in LV2 plugin format.

Install

Compiling this plugin requires the LV2 SDK, gnu-make, a c-compiler, libpango, libcairo and openGL (sometimes called: glu, glx, mesa).

  git clone git://github.com/x42/tuna.lv2.git
  cd tuna.lv2
  make submodules
  make
  sudo make install PREFIX=/usr

Note to packagers: The Makefile honors PREFIX and DESTDIR variables as well as CFLAGS, LDFLAGS and OPTIMIZATIONS (additions to CFLAGS), also see the first 10 lines of the Makefile. You really want to package the superset of x42-plugins.

Usage

# Just run the stand-alone app
x42-tuna
# Some info
man x42-tuna

Screenshots

screenshot screenshot

Operation Principle

The idea behind tuna.lv2 is to rely on the same principle as strobe-tuners and track a signal's phase. The advantage of this is that it is very reliable, accurate and works even at very low frequencies. While many FFT-based tuners use overtones to increase accuracy and speed. tuna.lv2 always tracks the fundamental of the note and can be used for accurate stretch-tuning.

The principle of mechanical strobe tuners is to simply spin a wheel which has regular markings painted on it. Then shine a stroboscope-light on the wheel which flashes at the frequency of the input signal.

If the signal is 'in-tune' the light-flashes match the frequency of the marks on the wheel and every time the marks are illuminated they will appear on the same position despite that the wheel is moving.

Tuna.lv2 models this behaviour using a delay-line and a delay-locked loop to track the changes of the phase. The phase-change corresponds to what appears as moving-pattern on the mechanical tuner and is visualized in the GUI of the plugin.

Tuna takes a two step approach:

First a rough DFT is used to determine the octave and rough frequency of the signal, this corresponds to setting the speed of the wheel in the mechanical version.

The detected frequency is rounded to the nearest note on the given scale (by default 440Hz tempered) and used to initialize the PLL.

This is only done for convenience of providing an 'auto-tuner'. Tuna.lv2 can be set to 'manual' in which case the user will have to choose which Note or frequency to tune to.

The input signal is band-pass filtered around the target-frequency in order to reliably extract the phase of the signal. The PLL is used to keep track of phase-changes and calculate the actual frequency of the input signal.