🎶 NoteBender - Harmonica Pitch Detection

👉 Try the Live Demo

NoteBender is a real-time pitch detection tool designed for harmonica players. It helps visualize what note you're playing, how accurately you're hitting it (in cents), and maps it to the blow/draw layout of a diatonic harmonica in various keys.

---

🧩 Features

• 🎙 Real-time pitch detection using microphone input

• 🔍 Visual feedback on which hole you're playing

• 🎯 Cents-level pitch accuracy with animated indicators

• 🎼 Support for multiple harmonica keys (C, A, D, etc.)

• 🔄 Automatically detects and highlights the closest matching note

• 📄 Load and visualize MusicXML files with harmonica tablature annotations

• 🔄 Automatic transposition with filters to avoid overblow, overdraw, or bend notes

• 🎹 Choose harmonica key and customize transposition semitones

• 📂 Upload your own MusicXML files for viewing and tabbing

• 🌀 Interactive Circle of Fifths visualization for exploring scales, modes, and chords

• 📦 Lightweight, fast loading — built with Vite

---

🛠️ Running Locally

This project uses Vite for fast development.

📦 Install dependencies

npm ci

🚀 Start development server

npm run dev

✅ Validate changes

npm test
npm run lint
npm run build