Play ABC tunes with synchronized diagrams for tremolo harmonicas.
4 = blow -4 = draw x = note unavailablex are valid. Hole numbers must fit the selected instrument.Add Tab adds harmonica hole number and technique tab to the current tune. Clear Tab removes harmonica tab.
You can edit the hole number and technique tab in the ABC. Valid tab changes the holes and techniques shown during playback. Other notes use the automatic hole number and technique. The music still sounds the same.
Preparing notation…
Export the current notation pane. Complete stave and tablature systems stay together on the same page.
The PDF tune title will link to the ABC Transcription Tools Player.
Overview
Load, type, or paste ABC tunes and play them with synchronized standard notation and a simulated two-row tremolo harmonica. The active pair of reeds is highlighted while the symbol below it shows whether to blow or draw.
It supports many common standard tremolo harmonica models and tunings, as well as the option to define a custom tremolo harmonica.
Tremolo Settings
Tremolo model selects one of the supported fixed model layouts. Each model uses a fixed note mapping rather than transposing a generic tuning.
Suzuki SU-13M: 13-Hole is available in C and Am.
Tombo 3116: 16-Hole (Low G) uses the Low G 16-hole layout and is available in C.
Tombo 2116: 16-Hole (Low A) uses the Low A 16-hole layout and is available in C.
Tombo 1521: 21-Hole provides all 12 major keys, all 12 harmonic minor keys, and all 12 natural minor keys. Natural minor tunings are labeled with Nm (for example, CNm).
Tombo 3121: 21-Hole is available in C, C#, Cm, G, G#, Gm, A, A#, and Am.
Tombo 3124: 24-Hole is available in C, C#, A, and A#.
Key shows only the mappings available for the selected model.
Octave shift shifts the tablature mapping by whole octaves from -3 through +3 without changing the written ABC notes.
Playback transpose shifts the playback pitch from -12 through +12 semitones without changing the written ABC notes or the displayed harmonica holes and blow/draw indications.
This can make it possible and simple to play tunes on a tremolo harmonica in a key different from the tune.
If the ABC contains a %%MIDI transpose directive, the Playback transpose setting takes precedence during playback; the original ABC is not changed.
Tuning, key, octave shift, and playback transpose are remembered in this browser and included in share links.
Tremolo Diagram
The diagram represents the two rows of a tremolo harmonica. Each playable note uses a vertically aligned pair of reeds; both holes in the pair are highlighted together. Green indicates blow and magenta indicates draw.
Display chooses Arrows or Text. Arrows show breath direction. Text shows the position number, with a leading – for draw. Tremolo layouts in this player use only blow and draw; bends, overblows, and chromatic-slide techniques are not supported.
Show note displays the current note on a staff beside the note name and is remembered in this browser.
Check Hide to clear the instrument display; it can be used if you want to practice a tune without seeing the instrument play techniques. Uncheck Hide to reveal the display again. This setting is remembered during normal use and can be changed without saving during a lesson.
ABC Editing and Notation
Editing the ABC rebuilds the notation and tremolo harmonica solution. Clicking a rendered note selects the complete ABC note token and updates the tremolo display to that note. Use the editor text-size menu to change the ABC editor text size.
The Full-Page View buttons expand the ABC editor, notation, or tremolo display. Press Escape to leave a full-page view; the tremolo view also provides an Exit Full-Page button.
Click on any note head in the notation and then use ← and → below the instrument display to step through the notes without playback.
Leave Use arrow keys? checked at the lower right of the instrument panel to navigate with the Left and Right Arrow keys, or jump to the first or last note with Home or End (including compatible Bluetooth keyboard foot pedals).
This option is on by default. Your choice is remembered in this browser.
When enabled, unmodified Left and Right Arrow keys step through notes, and Home and End jump to the first and last notes of the tune.
These keys navigate notes instead of moving the ABC editor cursor.
Keyboard shortcuts are temporarily disabled while dialogs or controls that use these keys are active. When this option is enabled, the shortcuts also work while the ABC editor has focus.
Uncheck the option to restore normal arrow-key behavior.
Playback Range
Select one or more notes in the ABC editor, or click a note in the rendered notation to select it.
The previous and next note buttons can also select notes without rebuilding the player until you click Set Playback Range.
The Set Playback Range button in the ABC editor header becomes available when your selection includes notes.
Restore becomes available whenever a playback range or Phrase Builder result is active.
Click Set Playback Range to temporarily replace the visible ABC, notation, and audio with the selected passage while retaining the tune's complete header and preceding comments, directives, and ABC fields.
Any part of the selection within the tune header is ignored.
Use the normal Play and Loop controls to practice just that passage.
To narrow the passage further, select notes within the currently displayed range and click Set Playback Range again.
You can repeat this process to create smaller nested playback ranges without changing the preserved original tune.
You can edit the temporary ABC while a range is active, and its notation and audio will update as you type.
Any changes you make to the ABC within a playback range are temporary and are not saved when the full tune is restored.
Click Restore to discard temporary Playback Range or Phrase Builder edits and restore the entire original tune, not just the previous range.
Saving ABC, creating share or lesson links, and opening tunes in ABC Transcription Tools always use the preserved full tune rather than the temporary range.
Clicking the main Export PDF button automatically discards any temporary Playback Range or Phrase Builder result and restores the full tune before preparing the PDF.
Changing tunes or loading another ABC file also discards any temporary Playback Range or Phrase Builder result and its edits.
You can use Tab Tools to inject tablature into the temporary ABC while a playback range is active.
Tab Tools changes made inside a playback range are temporary and are lost when the range is cleared or the tune is changed.
Changing the tremolo harmonica model, key, octave shift, playback transposition, or custom tuning clears the playback range and discards temporary edits.
If you cancel an instrument or tuning change that requires a tablature-removal confirmation, the current playback range and its temporary edits remain unchanged.
Opening Configure Custom Tuning without applying a new tuning also leaves the current playback range unchanged.
Phrase Builder
Phrase Builder creates a temporary call-and-response practice version of the ABC currently shown.
Choose the phrase length, extra rest measures, and number of times to repeat each phrase.
Your Phrase Builder settings are saved in this browser and are not included in share or lesson links.
Chord symbols are removed from the result.
You can first use Set Playback Range to select part of a tune, then use Phrase Builder on that passage.
After building phrases, Phrase Builder is disabled until you click Restore.
You can still use Set Playback Range as many times as you like on the phrase-built ABC.
Restore discards all temporary changes and brings back the complete original tune.
Saving, sharing, creating lessons, and opening a tune in ABC Transcription Tools always use the original tune.
Changing tunes or using the main Export PDF also restores the original ABC.
Phrase Builder cannot process tunes with V: voices or unsupported body-level ABC fields other than K:.
Cancelling Phrase Builder or entering invalid settings leaves the ABC unchanged.
Playback
The playback Loop setting is remembered in this browser and restored when you reopen the player (off by default).
Playback follows the notation cursor and tremolo display, highlighting the current position as the tune plays. The controls below the notation provide play/pause, restart, looping, seeking, and playback speed.
Mute Melody silences the melody while leaving accompaniment or metronome available. Metronome adds a click during playback. Count in? adds a five-second on-screen countdown.
Click Tempo to set playback speed from 10% to 200% of the tune's normal tempo.
Tab Tools (Add Tab / Clear Tab)
The Tab Tools button beside the Tune selector opens the Tablature Tools dialog for the current tune.
Add Tab inserts below-staff ABC tablature annotations for every note using the current harmonica model, key, and octave. It uses the same hole, breath direction, and supported playing techniques as the player display.
Tablature uses the ABC Transcription Tools harmonica hole and technique symbols. The draw minus sign appears on a second line beneath the hole number and technique; blow notes have no plus sign.
If the current tune already contains harmonica tab, Add Tab asks for confirmation before replacing it.
Clear Tab removes harmonica tab from the current tune after confirmation.
To inspect or edit the tab note by note, click a note in the notation, then use the ← and → buttons centered below the harmonica diagram to step through the tune and see each note’s hole number and technique on the diagram.
Changing the harmonica model, key, or octave checks all loaded tunes for harmonica tab. If any tune contains harmonica tab, the player asks for confirmation before clearing it from every affected tune. Canceling preserves the previous settings and all tunes.
Adding or clearing tablature marks the ABC as modified. Save the ABC file to retain the changes.
Playback tablature overrides: The tablature inserted by Add Tab shows the built-in solution for the selected harmonica model, key, and octave. You can edit any individual harmonica note tab in the ABC to override the hole and technique displayed while that note plays. Notes without a valid override continue to use the built-in solution. Harmonica tab with invalid tablature syntax or hole numbers outside the selected instrument’s hole count is ignored during playback. The player does not check whether an override produces the written pitch; the user is responsible for choosing suitable hole numbers and techniques. Overrides affect the displayed hole number and technique, not the audio pitch.
Reading and editing harmonica tab in ABC: Each hole number and technique appears in double quotes just before its ABC note. The leading _ places the tab below the staff.
| Symbol / Technique | ABC Example | Meaning |
|---|---|---|
| Hole number / blow | "_4" | Blow hole 4 (no draw mark). |
Draw: - | "_4;-" | Draw hole 4. ;- puts the draw mark below the hole number. |
No hole number and technique: x | "_x" | No available hole number and technique. |
Edit only the text between the quotes; leave the ABC note in place. Only hole number, blow, and draw can override playback in this player. Unsupported or out-of-range hole numbers or techniques are ignored.
Tab Tools is also available when running lessons.
Showing All Hole Numbers and Techniques for a Tune
Click All Techniques in the Notation pane header to view all hole numbers and techniques for the current tune in a new browser tab.
The separate printable sheet now includes its own Export PDF button, with the same Letter/A4 paper and portrait/landscape preferences as the main notation exporter.
All Techniques is available only with a graphical instrument Display style. When Display is set to Text, the button is disabled. Select a graphical display style to enable it again.
The sheet shows harmonica hole numbers and techniques and note names, including barlines, repeats, and endings, with one row per notation staff and no music notation.
All Techniques supports single-voice melodies only. Tunes with multiple voices, multi-note chords (such as [AB]), or inline key changes (such as [K:G]) are not supported; an alert will appear instead.
Use your browser’s print controls to print the sheet or save it as a PDF.
For best results with dense tunes, use landscape orientation when printing.
This feature requires pop-ups to be allowed on your browser.
Saving and Sharing
Save writes the current ABC collection to a file.
Share opens the Sharing Controls dialog. Share Current Tune creates a share link for the displayed tune and Share All Tunes creates one for all loaded tunes when the resulting link fits within the allowed size.
Shortcut: Option/Alt-click Share to open the current tune directly in ABC Transcription Tools in a new browser tab, without opening the sharing dialogs.
The Sharing Controls dialog closes and the selected link opens in a Share Link dialog where you can copy it, save it as a text file, test it in a new browser tab, or open the ABC in the ABC Transcription Tools. Click Close to close the Share Link dialog.
Open in ABCTT opens the selected ABC in the ABC Transcription Tools ABC Editor in a new browser tab with an ABCTT-compatible MScore harmonica (MIDI program 22) in place of the player's custom instrument, retaining the selected playback transpose. For a Lesson Share Link, lesson-only information is omitted and only the tune and applicable instrument settings are sent to ABC Transcription Tools.
The link includes the selected tremolo model, key, octave shift, and playback transpose.
Settings received from a share link are used for that visit without changing your saved preferences. If you change any player setting, the current share-link settings become your saved preferences too. Opening a file with Browse loads its ABC only and does not change player settings.
When opening a share link, click Click to Enable Playback before using the normal playback controls if your browser requires a user gesture to initialize audio.
Practice with the ABC Transcription Tools Tune Trainer
To practice the current tune in the ABC Transcription Tools, first click Share in this player, choose Share Current Tune, and then click Open in ABCTT in the Share Link dialog. The tune opens in the ABC Transcription Tools in a new browser tab. Alternatively, Option/Alt-click Share to open the current tune directly in ABC Transcription Tools, skipping the Share dialogs.
Once the tune is loaded, click Train above the ABC editor pane to start the Tune Trainer. To practice the tune phrase-by-phrase, click Phrase Builder in the Tune Trainer.
To export an MP3 audio file of the tune, click Play in the ABC Transcription Tools, then click the Export Audio, Image, or PDF button in its Player and select the MP3 audio export option.
ABC Files and Tune Selection
Open an .abc or .txt file, or paste ABC directly into the editor. Multi-tune files are supported; use the Tune menu to select the tune to display and play.
Layout Compatibility
Other Suzuki and Easttop 21- and 24-hole tremolo harmonica models should be compatible with the equivalent-key Tombo layouts in this player when they use the same note arrangement.
Custom Tremolo Harmonica
The Custom Tremolo option lets you create and save a 12-, 13-, 16-, 20-, 21-, 23-, or 24-hole tremolo layout. Choose Configure Custom Tremolo... in the Tremolo model menu to edit it.
The custom editor uses a five-octave, 60-note map.
The custom tuning initially matches the Tombo 1521 21-hole in C.
Each entry may be a hole number for blow (for example 4), a hole number preceded by - for draw (for example -4), or x for an unavailable note. Other harmonica technique indications as used in the diatonic harmonica player, for example bends and overblows, are invalid.
Initialize from Preset can start from any built-in model and any key available for that model, within the custom editor's five-octave range, or choose Reset All to x from the Model menu to reset every entry to x. When that option is selected, Key is set to None. The key choices change with the selected source model.
Load Tuning File accepts compatible custom harmonica settings from this player, the standard ABC Harmonica Player, or ABC Transcription Tools when all assigned notes use only blow and draw.
If the file has no usable tremolo hole count, the player infers the smallest suitable choice from 12, 13, 16, 20, 21, 23, or 24 holes; you may change it before saving.
The name, hole count, tablature entries, and every hole reference are validated when you save the custom tuning to the player or save a tuning file.
Save stores the custom tuning in this browser and makes it the active Custom Tremolo. Save Tuning File exports the tuning to a .txt file without changing the tuning saved in the browser. Changes made in the custom editor are not applied to the player or stored in this browser unless you click Save.
When a share link uses a custom tremolo definition, the complete custom definition is included in the link. The shared custom tuning is initially temporary and does not replace the custom tuning already saved in the recipient’s browser. If the recipient changes a player setting, the current share-link settings, including the shared custom tuning, become their saved preferences. The tuning can also be saved explicitly from the custom tuning editor.
Using Playback Transpose
Playback Transpose can be useful in many situations where you want the playback pitch to match the tremolo harmonica you actually have while keeping the displayed blow/draw positions appropriate for the tune. The following example uses a C tremolo harmonica because it is a straightforward way to see how the feature works.
It's especially useful if the only tremolo harmonica you have is in C, but you want to play along with tunes in other common keys.
Unlike a diatonic, you can't bend your way to missing notes on a tremolo, so choosing the appropriate instrument layout is particularly important.
For a tune in D major:
Select the equivalent D tremolo in the player.
Set Playback Transpose to -2.
Then play the displayed blow and draw positions on your C tremolo.
The playback is shifted to match your C instrument, while the hole display continues to show the appropriate relative positions for the tune.
Here's another example.
For an E Dorian tune, use the instrument that matches the major key of its key signature, which is D.
Select the equivalent D tremolo.
Set Playback Transpose to -2.
Then follow the displayed positions on your C tremolo.
This lets the player choose a layout containing all the notes required by the tune, while Playback Transpose lets you actually play along using your C instrument.
A simple rule for some common Irish tune keys is:
D major / E Dorian → D tremolo → Playback Transpose -2
G major / A Dorian / D Mixolydian → G tremolo → Playback Transpose -7 (or +5)
So if the only tremolo you own is in C, you can still use the player with a much wider range of tunes without running into notes that aren't available on your instrument.
ABC Harmonica Player
For diatonic and chromatic harmonicas, try the ABC Harmonica Player. It supports common diatonic and chromatic harmonica tunings as well as custom tunings.
Trademarks
Tombo, Suzuki, Easttop, and the referenced model names are trademarks of their respective owners. This independent tool is not affiliated with or endorsed by Tombo Musical Instrument Co., Ltd., Suzuki Musical Instrument Mfg. Co., Ltd., or Jiangsu East Musical Instrument Co., Ltd (Easttop). Brand and model names are used solely to identify supported or compatible harmonica layouts.
Export PDF
Use Export PDF to save the current tune as a PDF containing the notation and any displayed tablature.
If a Playback Range or Phrase Builder result is active, clicking the main Export PDF button first discards the temporary ABC and restores the full tune before preparing the PDF.
The tune title in the main notation PDF is clickable. Click it to open this tune in the ABC Transcription Tools Player using the same ABCTT-compatible MScore harmonica sound and transpose as Open in ABCTT. The separate All Techniques PDF export is unchanged.
The transferred melody uses MScore MIDI program 22 with bass and chord programs 0, volumes 64, replacing conflicting source directives. The player's custom Super64 sound is not transferred.
Choose Letter or A4 paper and Portrait or Landscape orientation.
By default, the PDF includes a centered Click the title to play instruction in the top margin of its first page. Uncheck Add "Click the title to play" on the first page header to omit it; the tune title and music do not move.
Each complete staff/tablature system stays together, with systems that do not fit moving to the next page.
For multipage tunes, page numbers appear centered at the bottom of each page.
A status dialog shows progress while the PDF is generated.
On an iPhone or iPad, tap Save PDF when the file is ready to open the iOS share sheet.
Choose Save to Files or another destination from that sheet.
On other devices, the PDF downloads automatically.
PDF export settings are saved locally and are not included in share or lesson links.
Printing Limitations
While running this tool, you can use your browser's Print feature to print the music notation displayed in the notation pane.
Tunes that are longer than one page may be cut off or clipped in the printout.
The browser's print scaling controls will not affect the size of the printed notation.
Experimenting with other paper sizes, such as Tabloid instead of Letter, may allow a longer tune to fit on a single page.
Manually setting larger left and right margins in the browser's Print dialog can often allow more staves to fit on a single page or possibly help with cleaner pagination.
Lesson Information for Music Teachers
Share opens the Sharing Controls dialog. Choose Configure Lesson… to create, edit, save, load, or share a lesson for your students.
A lesson uses the current tune only.
Enter a lesson title and instructions in the Configure Lesson dialog.
The lesson title and instructions are remembered in this browser while you work and are restored the next time you open Configure Lesson.
Save Lesson Configuration saves a reusable text file containing the current tune, lesson title, instructions, and the same player settings carried by a normal Tremolo Harmonica Player share link.
Load Lesson Configuration can open either a saved Lesson Configuration file or a Lesson Link saved as a text file.
Those saved player settings are Tremolo model, Key, Octave shift, and Playback transpose.
You can also open a saved Lesson Configuration with the main ABC file Browse button. In this case, only the ABC tune is loaded; the lesson title, instructions, and saved player settings are not applied.
If one or more tunes are already loaded, the tool asks for confirmation before replacing them with the lesson tune.
Loading a lesson configuration restores its tune, lesson title, instructions, and saved player settings. The restored player settings also become your saved preferences for future use.
Create Lesson Link creates a share link for the current tune containing the lesson title and instructions plus the same player settings carried by a normal share link.
The generated lesson link opens in the same Share Link dialog, stacked over the Configure Lesson dialog, where it can be copied to the clipboard, saved as a text file, tested in a new browser tab, or opened in the ABC Transcription Tools with lesson-only parameters removed. Click Back to close the Lesson Share Link dialog and return to Configure Lesson.
The Hide checkbox beside Show note lets you prepare a lesson with the instrument display initially hidden, so students can practice without seeing the instrument play techniques. Its checked or unchecked state is included in Lesson Links and saved Lesson Configurations. Students can change Hide during the lesson.
Lesson Information for Students
Your music teacher may provide you with a Tremolo Harmonica Player lesson link.
Open the lesson link in your web browser to load the tune, lesson instructions, and the player settings chosen by your teacher.
Read the lesson information that appears, then click Start Lesson when you are ready to begin.
After clicking Start Lesson, click Click to Enable Playback to enable the audio playback controls.
The lesson setup controls and the lesson tune selector are shown at the top of the player but are initially disabled so the teacher's lesson setup cannot be changed.
The Browse and Save controls remain available while you are using a lesson, but the Share control is hidden so you cannot create share links or lessons.
You can use the normal notation, hole number and technique display, playback, tempo, metronome, count-in, display, and full-page controls while working on the lesson.
You can edit the ABC if your teacher asks you to make changes.
Click Save to save your edited ABC.
You can use Browse to load a saved ABC file back into the player or open another ABC file. The lesson's player settings remain locked. After you load an ABC file, the tune selector is unlocked so you can select any tune in that file.
The Hide checkbox beside Show note may be initially checked by your teacher to let you practice without seeing the instrument play techniques. Uncheck Hide whenever you want to reveal the instrument display, or check it again to practice without it. Changing Hide during a lesson does not change your saved preference for normal player use.
About
This tool was created by
Michael Eskin
If you find it useful, please consider a contribution via
Support Michael Eskin's Music Tools