Tuner FS

Full-screen tuner module for VCV Rack 2 and the 4ms MetaModule.

Tuner FS analyses a monophonic audio input with the YIN pitch-detection algorithm and displays the note name, frequency, and cents deviation on a large, color-coded screen (green < 5 cents, yellow < 15 cents, red beyond). The input is passed through unmodified to the output.

Port	Type	Description
Audio In	Input	Audio signal to analyze (monophonic)
Audio Out	Output	Audio pass-through

Detection range: ~20 Hz – 4000 Hz, A4 = 440 Hz.

Screenshots

Simulated renders: the panel SVGs from res/ with the display drawn exactly as TunerFSDisplay::draw() does (same layout, colors and font). Jack graphics are approximated.

VCV Rack

In tune (A4, 440 Hz)	Far off (E2, −26 cents)	No signal

MetaModule

In tune (A4, 440 Hz)	Close (D3, +13 cents)	No signal

Download

Prebuilt packages are in dist/:

File	Target
TunerFS-2.0.0-lin-x64.vcvplugin	VCV Rack 2, Linux x64
TunerFS-2.0.0.mmplugin	4ms MetaModule

Checksums are in dist/SHA256SUMS.txt.

Install in VCV Rack 2 (Linux)

Copy the .vcvplugin file into your Rack user plugins folder (~/.local/share/Rack2/plugins-lin-x64/ or ~/.Rack2/plugins/, depending on your install) and restart Rack. Rack extracts it automatically.

Install on the MetaModule

Copy TunerFS-2.0.0.mmplugin onto the SD card or USB drive used by the MetaModule, then load it from the Plugins menu.

Building from source

Full instructions: docs/TUNERFS_BUILD_GUIDE.md.

VCV Rack

Requires the Rack SDK (defaults to ~/rack-sdk; override with RACK_DIR).

RACK_DIR=/path/to/Rack-SDK ./build-tuner.sh
# → build/plugin.so + build/plugin.json + build/res/

MetaModule

Requires the MetaModule plugin SDK and an arm-none-eabi toolchain.

git clone --recursive https://github.com/4ms/metamodule-plugin-sdk
cmake -B build-meta -G Ninja -S metamodule -DMETAMODULE_SDK_DIR=$PWD/metamodule-plugin-sdk
cmake --build build-meta
# → metamodule-plugins/TunerFS.mmplugin

Repository layout

src/            VCV Rack module sources
res/            Panel SVGs
metamodule/     MetaModule build (CMake, sources, plugin-mm.json)
assets/         MetaModule panel graphics
include/        Shared headers
plugin.json     Plugin manifest (shared by both builds)
dist/           Prebuilt packages
docs/           Build and usage guide
analyses/       Pitch-detection design notes

License

GPL-3.0 — see LICENSE.