GoTune

Minimal, fast CLI tuner for string instruments (currently guitar & bouzouki), written in Go.

🎬 Demo

🚀 Quick Start

Build:

go build -o gotune cmd/tuner

Run:

• Guitar:

  ./gotune

• Bouzouki:

  ./gotune -i bouzouki

🧪 Running Tests

Go tests

Run all Go tests:

go test ./...

Python reference tests

The Python implementation in python/ is the reference for pitch detection accuracy.

To run Python tests:

cd python
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python test_mpm.py

📖 Reference Implementation

The python/ directory contains a pure Python implementation of the McLeod Pitch Method (MPM), used as a reference for validating the Go port. Use it to compare results, function signatures, and accuracy.

Reference:

• McLeod, P., & Wyvill, G. (2005). A Smarter Way to Find Pitch

🛣️ Roadmap

• Android support
• Web app
• Add benchmarks
• Support more instruments?

🛞 Under the hood

gotune uses:

• malgo for the audio captures
• bubbletea for the TUI
• lipgloss for the styling
• vhs for generating the GIF