Melodeon.net Forums

Please login or register.

Login with username, password and session length
Advanced search  

News:

Welcome to the new melodeon.net forum

Pages: [1]   Go Down

Author Topic: New Tool: ABC Harmonica Player  (Read 199 times)

0 Members and 1 Guest are viewing this topic.

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
New Tool: ABC Harmonica Player
« on: September 29, 2026, 09:37:36 PM »

This is the latest of the standalone instrument-specific ABC players I’ve been working on. It leverages a lot of the work I’ve already done on the Tin Whistle, Anglo Concertina, Fretboard, and other players, so it has the same general interface and playback features.

For the harmonica-specific part, it uses the same exact harmonica tablature solutions available in the ABC Transcription Tools to provide a real-time display of the harmonica hole number and whether the note is played using a blow, draw, bend, overblow, overdraw, or chromatic slide technique.

You can choose between a Graphic display, which uses symbols to show the various harmonica techniques, or a Text display using the original ABC Transcription Tools text-style harmonica tablature.

As the tune plays, the harmonica diagram follows along in real time. You can also click on any note in the notation to immediately see how that note is played.

It supports Standard Richter, Paddy Richter, Easy Thirds, Melody Maker, Country (Major 7th), Natural Minor, and 12- and 16-hole Chromatic harmonicas, with all 12 harmonica keys and octave shifting.

Like the other standalone players, you can open or paste ABC tunes, play them with synchronized notation, change the tempo, use a metronome or count-in, loop playback, use full-page views, and share tunes with other users.

Demo video:

https://youtu.be/lEIDK7Vjiyc

Try the free ABC Harmonica Player here:

https://michaeleskin.com/tools/abc-harmonica-player.html

Are you just starting out learning to work with ABC notation?

This interactive tutorial will help you learn the basics:

ABC Notation Tutor

https://michaeleskin.com/tools/abc-notation-tutor/abc-notation-tutor.html
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: New Tool: ABC Harmonica Player
« Reply #1 on: September 30, 2026, 07:43:26 AM »

ABC Harmonica Player Version 2.0 - New Advanced Custom Harmonica Tuning Support

The latest 2.0 release of the ABC Harmonica Player adds a comprehensive Custom Harmonica Tuning system for users who need tablature mappings beyond the built-in harmonica tunings.

Custom tuning is an advanced feature intended for users who are already familiar with harmonica tuning layouts and with creating or editing harmonica tablature configurations.

Most users should continue to use the built-in tuning presets, which are unchanged.

------------------------

60-Note Custom Tuning Map

A custom tuning consists of a 60-note chromatic mapping covering five complete octaves.

The editor presents the notes as five groups of 12 chromatic notes, from C through B. For each of the 60 notes, you specify the harmonica hole and playing technique that should be used to produce that note.

Custom tunings can be configured for:

10-hole harmonicas

12-hole harmonicas

16-hole harmonicas

Every hole referenced in the mapping must be valid for the selected harmonica size.

A note that isn’t available on the instrument can be assigned x.

------------------------

Tablature Mapping Syntax

Each entry begins with a hole number, optionally preceded by - for a draw note, and can include supported technique characters.

The basic technique characters are:

- = draw

’ = bend by one semitone

’’ = bend by two semitones

’’’ = bend by three semitones

o = overblow or overdraw

s = slide-in

x = note unavailable

Examples include:

4 = blow hole 4

-4 = draw hole 4

-3’ = draw hole 3 with a one-semitone bend

-3’’ = draw hole 3 with a two-semitone bend

-3’’’ = draw hole 3 with a three-semitone bend

6o = hole 6 overblow

-7o = hole 7 overdraw

1s = hole 1 slide-in

x = note unavailable

Supported technique characters may be used in the combinations accepted by the custom-tuning validator; the examples above illustrate the syntax rather than being an exhaustive list of every accepted combination.

The player validates all 60 entries and checks that every referenced hole fits the selected harmonica size before a tuning can be saved.

------------------------

Compatibility with ABC Transcription Tools

The custom tuning system is based on the ABC Transcription Tools custom harmonica tablature configuration format.

You can open custom harmonica tuning files created by ABC Transcription Tools as long as their mappings use supported hole numbers and the allowed technique-definition characters.

Because ABC Transcription Tools custom tuning files do not contain a harmonica hole count, the Harmonica Player initially determines an appropriate 10-, 12-, or 16-hole setting from the highest hole referenced in the imported configuration. You can then change the instrument size while editing the tuning.

The Harmonica Player can also save and reload its own custom tuning configuration files. Files saved by the player include the selected hole count in addition to the tuning name and 60-note map.

These files are also compatible with the ABC Transcription Tools custom harmonica tuning loader. ABC Transcription Tools simply ignores the additional hole-count information added by the Harmonica Player.

------------------------

Custom Tuning Editor

Choose Configure Custom Tuning… from the Harmonica tuning menu to open the editor.

The editor lets you:

Name the custom tuning

Choose a 10-, 12-, or 16-hole harmonica

Edit all 60 chromatic note mappings

Load a tuning configuration file

Save a tuning configuration file

Initialize the editor from any built-in tuning

Reset all 60 notes to x

Opening the editor does not automatically change the tuning currently being used. Likewise, loading a tuning file or initializing from a preset only changes the contents of the editor. Your existing saved custom tuning is not replaced until you explicitly click Save.

------------------------

Initialize from a Built-In Tuning

Initialize from Preset provides a convenient starting point when creating a new tuning.

Selecting one of the built-in tunings copies its complete tablature map into the custom editor, selects the corresponding 10-, 12-, or 16-hole instrument size, and gives it a name beginning with Custom.

You can then modify individual note mappings as necessary without altering the original built-in preset.

Reset All to x instead creates an empty starting configuration by assigning x to all 60 notes.

------------------------

Validation and Safe Persistence

A custom tuning must pass validation before it can be saved.

The player validates the tuning name, instrument size, number of mapping entries, tablature syntax, and referenced hole numbers. A custom map must contain exactly 60 entries.

Invalid configuration files do not replace an existing saved custom tuning.

Once a valid tuning is saved, its name appears in the Harmonica tuning menu and the player automatically switches to it. The custom tuning is stored locally in the browser for future sessions.

------------------------

Custom Tunings in Share Links

Custom tunings are fully supported by the Harmonica Player’s share-link system.

When you create a share link while your custom tuning is selected, the link contains the complete custom tuning configuration, including:

Custom tuning name

10-, 12-, or 16-hole instrument size

All 60 tablature note assignments

This means the recipient does not need to have your custom tuning installed beforehand. Opening the share link reconstructs and validates the embedded tuning and temporarily uses it for the shared music.

Importantly, a custom tuning received through a share link does not overwrite the recipient’s own saved custom tuning.

The shared tuning is temporary. The recipient is notified that the custom tuning came from the share link and that their existing browser-saved tuning has not been replaced.

If they want to keep the shared tuning for future use, they can open Configure Custom Tuning… and click Save. harmonica-custom(20260930-061221).html

------------------------

Built-In Tunings Are Unaffected

The custom-tuning system is separate from the normal built-in tuning system.

Selecting a standard tuning continues to use its original built-in tablature map. The custom 60-note map is used only when the custom tuning itself is selected.

For most users, therefore, nothing changes: simply select one of the standard harmonica tunings and use the player as before.

------------------------

The new Custom Harmonica Tuning feature is there for advanced users who need to model specialized, altered, or personally configured harmonica layouts—and provides a way to create, validate, save, load, exchange, and share those configurations without changing the standard tuning presets.

Logged
Pages: [1]   Go Up
 


Melodeon.net - (c) Theo Gibb; Clive Williams 2010. The access and use of this website and forum featuring these terms and conditions constitutes your acceptance of these terms and conditions.
SimplePortal 2.3.5 © 2008-2012, SimplePortal