abcMIDI package

abcMIDI is a package of programs written in C for handling abc music notation files. The software was created by James Allwright in the early 1990 and presently maintained by Seymour Shlien. It initially included the following programs:

1. abc2midi for converting an abc file to a midi file,
2. abc2abc for transposing abc notation to another key signature,
3. midi2abc for creating an abc file from a midi file,
4. yaps for producing a PostScript file displaying the abc file in common music notation and,
5. mftext for creating a text representation of a midi file.

Seymour added two more programs:

1. abcmatch for finding common elements in a collection of abc tunes and,
2. midicopy for copying parts of a midi file to a new midi file.

Yaps has been superceded by Jef Moine abcm2ps and abc2svg programs. Midi2abc has been expanded to include mftext and various other features for supporting the runabc application. Abc2midi has numerous new features that are described in its own web page abc2midi guide.

Components of the abcMIDI package are parts of numerous applications for creating and editing abc files. Compilations of these components for various operating systems can be found on The ABC Plus Project web page.

The latest version of the abcMIDI package supported by James Allwright can be found can be found here. More recent versions can be found on sourceforge and on the runabc web page.

Building

Autoconf (legacy)

The traditional build uses autoconf:

./configure
make
sudo make install

CMake (modern)

A CMake build system is available alongside the legacy one, with presets for common configurations:

# Configure and build (pick a preset: default, debug, sanitize)
cmake --preset default
cmake --build --preset default

# Install
cmake --install build/default

Available presets:

Preset	Build type	Description
default	Release	Optimized build
debug	Debug	Debug symbols, no optimization
sanitize	Debug	Debug + AddressSanitizer + UndefinedBehaviorSanitizer

The CMake build generates compile_commands.json for use with clangd and other LSP-based editors.

Testing

The CMake build includes a test suite covering all 8 programs:

• Smoke tests verify each binary runs cleanly with -ver.
• Golden-file tests run each program on a sample input and compare the (normalized) output to a checked-in reference. Binary MIDI outputs are piped through mftext to produce diffable text. Volatile lines (version banners, dates, temporary paths) are stripped before comparison.

# Run all tests
ctest --preset debug

# Run only golden-file tests / only smoke tests
ctest --preset debug -L golden
ctest --preset debug -L smoke

To regenerate the golden files after an intentional behavioural change, review the diff, then commit:

cmake --build build/debug --target update-golden
git diff tests/golden/