https://tcanabrava.github.io • This is a web feed, also known as an Atom feed. Subscribe by copying the URL from the address bar into your newsreader. Visit About Feeds to learn more and get started. It's free. Visit website Recent posts Updated on $DATE dark date gamedev Somewhat updated list of C++, Qt and KDE bits Zola2026-08-31T00:00:00+00:00https://tcanabrava.github.io/tags/gamedev/atom.xml 2026-08-31T00:00:00+00:00 2026-08-31T00:00:00+00:00 Tomaz Canabrava https://tcanabrava.github.io/introducing-harmonicon/ <p>For once, something on this blog that isn’t C++.</p> <p>Harmonicon is a rhythm game for blues harmonica. Notes scroll toward a hit line and you play on an actual harmonica, into your microphone, and the game listens.</p> <h2 id="the-idea">The idea</h2> <p>The harmonica is cheap, fits in a pocket, and it hides everything: the reeds are inside, your tongue and throat do most of the work, and nothing about the instrument tells you whether the note that just came out is the note you meant. You can practise a bend wrong for a month quite happily.</p> <p>Let the instrument be the input. Harmonicon captures the microphone, runs pitch detection on it in real time, and scores what you actually played against the chart. Every note you score is a note you genuinely hit.</p> <h2 id="playing-a-song">Playing a song</h2> <p><img src="https://tcanabrava.github.io/introducing-harmonicon/play-2d.png" alt="The 2D play mode: a lane per harmonica hole, with notation and a tab readout above" /></p> <p>The default view is one lane per hole: ten for a diatonic, twelve for a chromatic, taken from whatever the chart was written for. Blue notes are blows, orange are draws, and the number on each is the hole you need. Above the lanes there’s the phrase in standard notation and as harmonica tab, because those are the two ways harmonica players actually read music, and the panel on the right tells you which harp to pick up and which position you’re playing in.</p> <p>There’s also a 3D view, which is the same game rendered around a harmonica model that moves with the beat.</p> <p><img src="https://tcanabrava.github.io/introducing-harmonicon/play-3d.png" alt="The 3D play mode: notes travelling down toward an animated harmonica model" /></p> <span id="continue-reading"></span><h2 id="getting-away-from-charts">Getting away from charts</h2> <p>Charts are good for learning a song and bad for learning to play. The Jam Session mode drops the scoring entirely and gives you a rolling 12-bar blues to improvise over.</p> <p><img src="https://tcanabrava.github.io/introducing-harmonicon/jam-session.png" alt="Jam Session: a 12-bar chord grid on the left, a live-tinted hole map on the right" /></p> <p>The useful part is the hole map on the right. As the backing moves through the bars, each hole recolours: gold if it’s a chord tone of the bar sounding right now, green if it’s elsewhere in the blues scale, dim if it’s going to sound wrong. You follow the colour instead of trying to recall theory at tempo, and the theory arrives later, on its own.</p> <h2 id="lessons">Lessons</h2> <p><img src="https://tcanabrava.github.io/introducing-harmonicon/lessons-list.png" alt="The lessons list, grouped into units from fundamentals to jazz" /></p> <p>There’s a curriculum underneath all of this, grouped into units and gated by prerequisites — from getting one clean single note out of the thing, through bends and articulation, up to improvising over a blues. Some lessons are scored drills. A few aren’t scoreable at all: tongue blocking sounds identical to puckering from the microphone’s point of view, so that one is instruction you mark as done and the game trusts you.</p> <h2 id="under-the-hood">Under the hood</h2> <p>Rust, with <a rel="external" href="https://bevyengine.org/">Bevy</a> for the engine and <code>cpal</code> for audio capture. The interesting problem is the pitch detection, which is why there are five algorithms to chose from: FFT, YIN, pYIN, MPM and NMF.</p> <h2 id="status">Status</h2> <p>There’s a lot in it — a bending trainer, an in-game song editor with MIDI import, adaptive difficulty, A–B looping, latency calibration, a spectrogram — but “early/experimental” is an honest label rather than modesty.</p> <p>It’s MIT licensed and the code is at <a rel="external" href="https://github.com/tcanabrava/harmonicon">github.com/tcanabrava/harmonicon</a>. If you own a harmonica and a microphone, that’s the entire hardware requirement.</p>

For once, something on this blog that isn’t C++. Harmonicon is a rhythm game for blues harmonica. Notes scroll toward a hit line and you play on an actual harmonica, into your microphone, and the game listens. The idea The harmonica is cheap, fits in a pocket, and it hides everything: the reeds are inside, your tongue and throat do most of the work, and nothing about the instrument tells you whether the note that just came out is the note you meant. You can practise a bend wrong for a month quite happily. Let the instrument be the input. Harmonicon captures the microphone, runs pitch detection on it in real time, and scores what you actually played against the chart. Every note you score is a note you genuinely hit. Playing a song The default view is one lane per hole: ten for a diatonic, twelve for a chromatic, taken from whatever the chart was written for. Blue notes are blows, orange are draws, and the number on each is the hole you need. Above the lanes there’s the phrase in standard notation and as harmonica tab, because those are the two ways harmonica players actually read music, and the panel on the right tells you which harp to pick up and which position you’re playing in. There’s also a 3D view, which is the same game rendered around a harmonica model that moves with the beat. …