Tunra

In tune, the bubbles line up.

Chromatic tuner: the nearest note, how many cents sharp or flat, the frequency and how sure it is, against an adjustable A4. Audio passes untouched.

● Freeorg.sournd.analysis.tunra

Hear it

Hear its studio demo. The live engine, with every parameter, is in your download.

Details

Engine id: org.sournd.analysis.tunra
Category: Analysis
Type: Tuner
Licence: Free, closed library (use it in any plugin)
Version: 1.0.0
Parameters: 2
Latency: none
Tail: 0 s
Sidechain input: no
Channels: mono or stereo

Parameters

The id is the C ABI parameter id and the JUCE parameter id (as a decimal string).

Id	Key	Name	Min	Max	Default	Unit	Taper
0	`reference_a4_hz`	A4 reference	400	480	440	Hz	linear
1	`sensitivity`	Sensitivity	0	1	0.5	-	linear

Readouts

Read with sournd_engine_readout_value on the audio thread.

Index	Key	Name	Kind	Min	Max	Unit
0	`note`	Note	note	0	127	-
1	`cents`	Cents	value	-50	50	cents
2	`frequency_hz`	Frequency	value	0	2000	Hz
3	`confidence`	Confidence	meter	0	1	-

How it is made

Original sOURnd tuner blending general techniques: a decimated difference-function pitch estimate refined by a full-rate difference minimum with parabolic interpolation, and a periodicity-based confidence.

CMake

cmake

juce_add_module(path/to/sournd_engine)
target_include_directories(MyPlugin PRIVATE path/to/include)
target_link_libraries(MyPlugin PRIVATE sournd_engine path/to/libsournd_cabi.a)

Three lines. Full steps: JUCE quick start.

C++ (JUCE)

cpp

#include <sournd_engine/sournd_engine.h>

sournd::SourndEngine engine { "org.sournd.analysis.tunra" };
juce::AudioProcessorValueTreeState parameters { *this, nullptr, "Parameters",
    sournd::SourndEngineParameters::createLayout (engine) };
sournd::SourndEngineParameters bridge { engine, parameters };

// prepareToPlay
engine.prepare ({ sampleRate, (juce::uint32) maximumBlock, 2 });
bridge.prepare (sampleRate);
setLatencySamples ((int) engine.latency());

// processBlock
bridge.apply ((uint32_t) buffer.getNumSamples());
juce::dsp::AudioBlock<float> block { buffer };
engine.process (juce::dsp::ProcessContextReplacing<float> { block });

// get/setStateInformation: hold getCallbackLock() around saveState / loadState,
// so state work never overlaps processBlock (full example: /docs/juce/)

Plain C

sournd_engine *e = NULL;
if (sournd_engine_create("org.sournd.analysis.tunra", &e) == SOURND_OK) {
    sournd_engine_prepare(e, 48000.0, 512);
    sournd_engine_set_param(e, 0, 440); /* A4 reference */
    sournd_engine_process(e, in, out, 2, frames);
    sournd_engine_destroy(e);
}

Ask your AI

Paste this into your coding assistant:

Prompt

Add the sournd engine org.sournd.analysis.tunra to my JUCE plugin. Follow https://sournd.com/docs/juce/index.md
and the engine reference at https://sournd.com/engines/tunra/index.md. Expose every parameter through APVTS.