Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Playing a Song

Play → Play Song starts the scored song flow:

  1. Select Song — browse all downloaded songs and anything you’ve added to ~/Harmonicon/songs/ (see Getting Started). Click a column header to sort by song name, band, instrument, genre, difficulty, your rating, mastery, or times played; click it again to reverse the order. The Instrument column says whether a song is a harmonica, guitar or flute part. A guitar or flute part also says how much of it your own instrument can play, from the tuning, capo and foot joint in My instruments: “Guitar · 83%” with a capo that puts the low notes out of reach. It counts note by note; the page before the song gives the exact count. Search accepts partial words and small typos, and matches the instrument too.
  2. Click a song once or use Up/Down to select it and inspect its details. Click Play to start the selected song. / focuses Search; Clear resets the search. Moving the pointer over other songs keeps your selection.
  3. Say what you are holding: the harmonica’s key and type for a harmonica part, the tuning for a guitar part, the foot joint for a flute part (see below). A 3-2-1 countdown then shows the song title and key before the chart and backing track start.

Select a song, then click its My rating stars to set the rating directly. The left half of a star chooses a half-star step; the right half chooses a full star. Click the current rating again to clear it to zero. Ratings range from zero to five stars in half-star steps (stored as 0–10). Mastery shows the accuracy from your latest completed gameplay, even when it is lower than an earlier result. — means no result has been recorded. Filter mastery cycles through all songs, unplayed songs, below 50%, 50–79%, and 80–100%; it combines with Search. Ratings and latest results are saved across restarts, separately for each song source. Times played counts completed song runs, including previously saved plays; click its column header to sort by the count.

When a repository check finds newer songs, an Update songs button appears above the catalog. Confirm it to download that repository’s latest version; the catalog refreshes when the download finishes. If a download fails, the existing songs remain available and you can retry the update. Checks are available in Options → Lessons & songs.

Guitar parts

A song folder can contain several charts. Select the part from the song list: filenames distinguish entries such as Duet — harmonica and Duet — guitar. Each part uses the same folder’s backing audio and background. Ratings, play history, adaptive progress and hiding currently apply to the song as a whole; separate progress per part is still planned.

Guitar charts use a horizontal tablature highway: strings run from high to low, notes approach from the right, and each note shows its fret number. A b marks a bend; angle brackets mark a natural harmonic. Scoring checks the sounding pitch, so an equivalent fingering sounds the same to the game.

For imported scores, the part picker offers guitar arrangements alongside harmonica arrangements and names the instrument beside each part. Guitar Pro tabs retain their tuning and string/fret positions. The Song Editor opens native guitar charts on its grid, one row per string. The fretboard strip beside the highway highlights the target frets and hand window.

Before a guitar part starts, Your guitar asks for your tuning: standard, drop D, half a step down, DADGAD, open G or open D, or As written. It opens on the tuning in My instruments, or the chart’s own if you haven’t named one there, and your answer is remembered for the next guitar part. Pick another and the notes stay the same pitches but move to the frets your tuning plays them on; the page says how many move. A bend keeps its bend; a natural harmonic, whose pitch depends on the open string, is played as the fretted note it sounded.

Capo works the same way: say which fret yours is on, or No capo, and it is remembered too. Frets then count from the capo, as tab for a capoed guitar does, and the line under the highway says so (“0 = the capo, at fret 2”). A note lower than your capoed strings can reach is shown but doesn’t count.

Flute parts

A flute part’s highway has one row per note the song uses, highest at the top, each named at the hit line, and every note carries its name as it travels in from the right.

Under the highway, a fingering chart shows how to play the note that’s coming. It is drawn the way a printed chart is, lying along the screen with the head joint at the left: the six finger holes in a line on the tube, left hand then a gap then right hand. The thumb key sits below the first hole, and the G♯ key, the two trill keys and the right little finger’s E♭ and foot keys sit small above the line. The keys to press are filled in, with the note’s name before the chart. The bar under it fills as the note approaches, turns gold when the note starts, and empties as you hold it. The keys turn gold too while the game hears the note. To the right, a smaller, dimmer chart shows the note after it, so your fingers can get there in time. The staff at the top marks the same note in gold.

Before a flute part starts, Your flute asks for its foot joint: a C foot goes down to C4, a B foot to B3. It opens on the one in My instruments, or the chart’s own until you’ve picked one, and your answer is remembered. A note below your foot (a B3 on a C foot) is still shown but doesn’t count, and the page says how many there are.

To hide the fingering chart, pause and press Fingering chart; the highway takes its space. Press it again to bring it back. Your choice is kept for later songs and sessions; Options sets it too.

A note’s fingering is a suggestion, as on every instrument: the game hears only the pitch, so an alternate fingering that sounds the same note scores the same. A chart may ask for a particular alternate, and the fingering chart then shows that one. Flute charts open in the Song Editor; see Flute charts.

Removed and hidden songs

Updates keep your local copy of songs removed from a repository, including backing tracks. Select one to see Kept locally — no longer in … and its source repository. If it returns to that repository, the latest copy replaces the retained version and the warning disappears. Each repository keeps its own copies independently.

Delete song hides the selected song from that source after confirmation; it keeps the files. Hidden songs stay hidden across updates and restarts, even if their chart filename changes. A copy from another repository remains visible. Exclusions are stored in hidden-songs.json beside settings.json. To restore a hidden song, remove its entry from that file while the game is closed.

Pickups and repeats

Some tunes start before the first full bar — the “and a” before bar 1. The game counts those opening notes as the end of an extra bar, the way a musician would: the metronome accents bar 1’s downbeat rather than the first note, and the beat guides and notation staff line up with it.

A song written with repeat signs plays them out in full. A repeated passage comes round again, first- and second-time endings are taken on the right pass, and every note of every pass is scored.

Lyrics

A song with words shows them karaoke-style under the notation staff: the current line lights up syllable by syllable as each one’s note is played, and the next line waits dimmed below it so you can read ahead. Songs without lyrics show nothing there.

Scoring

As notes reach the hit line, Harmonicon compares the pitch it hears against what the chart expects, at that instant:

  • Perfect / Good hits, based on how close your timing was to the note’s onset.
  • Miss, if the window passes with nothing (or the wrong pitch) played.
  • Longer notes reward holding the correct pitch for their full duration, not just landing the onset.
  • Special techniques — bends, vibrato, wah, overblow/ overdraw, and (chromatic only) slides — are validated on their own terms, not just “was some pitch playing”: a bend note checks you actually bent to the target pitch, a vibrato/wah note checks the oscillation rate you played matches what the chart asks for.
  • Every note is a ribbon as long as the note lasts. Its bright front edge is the attack — play when it reaches the hit line — and the technique is drawn along it: a vibrato is a wavy line and a wah pinches the ribbon in and out, both spaced so each swing crosses the hit line at the rate the chart asks for (follow the ribbon and you’re wobbling at the right speed); a bend steps the ribbon’s bright core sideways, further for a deeper bend.
  • Each technique note says what it wants. The note’s tab carries the bend depth — one ' per half step, so -3'' is draw 3 bent a whole step — and a short label beside the note gives the note to land on (→ A) or the wobble rate to play (vib 5/s: five swings a second).
  • A coach bar at the end of the track guides the technique as you play it. It sits between the highway and the hole strip, never moves, and uses large type. For a bend it runs from the unbent note on the left to the target on the right, with the target band in green; the marker is your pitch, so bending slides it right, and it turns green once you’re there (Bend more / Hold it / Too far). For vibrato or wah, a pale tick swings at the rate the chart asks for — copy it — and once you’re holding the note your own pitch (vibrato) or volume (wah) swings beside it, with Faster, Slower, Wider or Good at the end, judged exactly as the score is. Songs without bends, vibrato or wah don’t show the bar.
  • Chords and octave-split notes only score when every note in the group sounds together — playing the same holes correctly but one at a time doesn’t count.

Every judgment shows on the note itself, not just in the readout by the hit line: a hit note’s ribbon widens for a moment and turns gold, its tab becoming a ✓; a missed one narrows, dims to red and gets a ✗ — so hit and miss are told apart by shape as well as colour. While you hold a long note, the part of its ribbon still above the line stays gold as long as the right pitch is sounding and goes grey the moment it drops out; on a vibrato or wah note the gold shimmers once the wobble is heard at the right rate, before the hold ends, so you can correct it in time.

A combo multiplier builds on consecutive hits and resets on a miss. The Results screen after each song is written as coaching, not just a scoreboard:

  • Accuracy leads, with one observation under it — the single most useful thing the run showed: a technique that trailed your plain notes, too many notes that never sounded, hits that consistently came in late or early, or attacks with a neighbouring hole leaking. It only says something it has evidence for — one attempted bend is never “your bends need work” — and says “nothing stands out” when a run is solid.
  • Timing as a distribution, not an average: an early / on-time / late bar with the counts. The one-click Input lag adjustment (see Calibrating Input Lag) appears only when your hits actually lean one way, since a wide scatter can average to a number without any lag being the cause.
  • By technique, ranked by where practice would pay off most, always with the sample counts alongside.
  • Practice missed section loops the two bars where you missed the most, using the same A–B loop the pause menu offers, and starts you there rather than from the top of the song. Leave it with Esc → Quit Song, or clear the loop from the pause menu to carry on through the rest.

For a lesson, the pass/fail verdict and how far you got toward its goal sit above all of that.

Pausing and quitting

Press Esc, or click the ⏸ button in the bottom-right corner, to pause mid-song — the on-screen button works the same as Esc, no keyboard required. The pause menu is two columns: Resume / Restart / Quit Song on the left, every practice aid on the right, so a slip of the mouse over one can’t misclick the other. The practice aids:

  • Wait for Note — freezes the highway and music the instant an unhit note reaches the hit line, and holds there until you play it — useful for slowing down a hard passage without losing your place. There’s no way to “miss” a frozen note; it just waits.
  • Practice Speed — a slider from 50% to 100% that slows the highway and metronome without pitch-shifting the audio; it mutes instead below 100%, so you never hear a chipmunked backing track.
  • Sections — while paused, the song’s score is shown with its sections marked above it. Click a section to select it; the two aids below act on whichever one is selected.
  • Phrase coverage — off by default (turn it on in Options, under Audio); once on, a song’s notes unlock gradually as you clear each phrase cleanly, instead of throwing the full chart at you immediately. This is one setting shared by every song, not something you pick per song. Its slider sets how much of the selected section is revealed, and the pause menu’s own toggle switches the feature off or on immediately, mid-song (this also updates the Options-menu setting).
  • Repeat section — loops the selected section, for drilling one phrase repeatedly. Resume to practise it; toggle it again to stop looping.

See the Controls Reference for every in-game keybinding.