Runabc is a graphical user interface to several command line driven programs for processing abc files. It is written in Tcl/Tk script and will run on any computer or operating system in which Tcl/Tk is installed. This includes Windows, Unix, Linux and Macintosh. The script now provides graphical user interfaces to abc2abc, abc2midi, abc2ps, abcm2ps and yaps. You also need a midi player and a postscript viewer. If you are running on Windows (2000, XP, Vista, Windows 7, Windows 8) or Linux. you can get many of the executables here and also from the web site The ABC Plus Homepage. For other systems you will probably need to download the sources and compile them yourself. The link below illustrates the operation of this program. The link install.html provides links to web sites where you can get the various components to run the program.

runabc.html describes what this program does. Updated 2019-04-18. You can also download the entire documentation in a zip file Updated 2019-04-03.

You can download the latest version of runabc.tcl here
2.093 May 15 2019 Source code
2.093 May 15 2019 Windows executable
2.093 May 15 2019 starkit
1.967 November 12 2015 Linux binary
1.939 June 10 2015 Mac binary
1.939 June 11 2015 Alternative Mac binary
2.093 May 15 2019 Windows install
1.021 April 15 2019 Source code only
runabc.exe has Tcl/Tk built in for Windows users who do not wish to install Tcl/Tk 8.5 on their system. Runabc.exe is now created using tclkit ( First save it to your hard drive and then run (no installs).

runabcexe is a similar executable with Tcl/Tk builtin for Linux.

runabc.kit will run without tcl/tk on almost any system where tclkit has been installed. See install.html for details.

For Windows system, setup_runabc.exe will install runabc.exe and the abcMIDI executables, and create shortcuts on your start button and Desktop. Runabc will now work properly even if it is installed in the c:\Program Files (x86) folder. It will create a separate folder in your home folder called runabc_home where it will store runabc.ini and other files that it needs to write.

The Windows executable runabc.exe may return some strange error messages on Windows 10; for example
bad component "item": must be row or column while executing ".abc.titles.t identify item $locx [expr $locy+2]" (procedure "update_wholefile_and_toc" line 12)
In such situations I recommend installing the tcl/tk interpreter from www.activestate/activetcl. Download and install the community edition (ActiveTcl8.6.4.1....exe) for x86, not 64-bit. This should fix the problem with runabc.exe. Otherwise run the source code by clicking on runabc.tcl. is a new program under constant developed which is described on sourceforge. The source code here is unstable, but stable versions are available in the midiexplorer project on sourceforge.


You need

abc2abc 2.01 December 21 2018
abc2midi 4.20 March 30 2019 1.3.3 December 2 2000
yaps 1.71 December 21 2018
midi2abc 3.31 May 15 2019
midicopy 1.30 December 15 2017
abcmatch 1.72 December 2018

You may find the sources of most of these files in the latest version of abcmidi (see below)  and you can obtain the executables for various operating systems from Guido Gonzato's web site - The ABC Plus Homepage.

The latest version is May 15 2019

Executables for the Microsoft Windows operating systems are also available in the zip file This file was updated on May 15 2019 (includes abcm2ps-8.14.4 executable).

Documentation abc2midi guide . The guide was updated June 24 2018.

Other abc file links may be found in The abc Homepage.

Sample Abc files I have contributed

Balkan dances vol 1 updated 2015/12/09
Balkan dances vol 2 updated 2015/12/09
Israeli dances updated 2015/12/09
International dances updated 2015/12/09
Esac Database
Nottingham Database
Turkish Makams updated 2016/04/29
Klezmer Database cleaned up updated 2015/12/15
Ottawa Slow Jam
From **kern files introduced 2019/01/04
work in progress updated 2015/12/09

EasyAbc Support

Nils Liberg has been too busy to support EasyAbc. Some numerous bug fixes have been contributed and you can find updated source code here.


May 15 2019 midi2abc: improved handling of accidentals and bug fixes.
April 23 2019 midi2abc changed invisible rest to visible rest
April 21 2019 runabc - new release
April 13 2019 midi2abc segmentation error fixed
March 23 2019 abc2midi. Fix for -c option for large files.
March 14 2018 runabc. Numerous bug fixes in editors.
March 14 2019 abc2midi. Fixed problem with line numbers in warnings.
February 10 2019 runabc. Option to suppress fermatas in advanced abc2midi settings.
February 08 2019 abc2midi recognizes dotted bar lines
January 31 2019 abc2midi. Option to suppress mixed tuplets warning.
January 20 2019 abc2midi. Removal of clef warnings.
January 18 2019 runabc. More options in reformat tool.
January 01 2019 abc2midi. Reduction of more error messages.
December 21 2018 abc2midi. Eliminated error message for THICK_THIN bar line.
December 01 2018 abc2abc. Fixed a bug with repeat symbols.
October 25 2018 midi2abc. Added -mftextpulses option
June 23 2018 abc2midi fixed problems with %%MIDI gchordbars and drumbars.
June 13 2018 midi2abc. Added a check for bad time increment.
May 02 2018 abc2midi. Deprecated ped-end added ped-up.
April 24 2018 midi2abc -stats (update)
April 16 2018 abc2midi bug fix (Barfly stress model)


This page was last updated on May 15 2019.