Provided by: abcmidi_20200122-1_amd64 
NAME
midi2abc - program to convert MIDI format files to abc notation
SYNOPSIS
midi2abc -f infile [-xa] [-ga] [-a acbeats] [-m time signature] [-ppu parts per unit]
[-aul denominator of unit length] [-gu] [-b bars] [-Q tempo] [-u pulses] [-k key] [-c
channel] [-obpl] [-bpl bars] [-bps bars] [-o filename] [-s] [-sr units] [-sum] [-nb] [-nt]
[-splitvoices] [-midigram] [-mftext] [-mftextpulses] [-nogr] [-title string] [-origin
string]
DESCRIPTION
midi2abc takes a MIDI format file and converts it to something as close as possible to abc
text format. The user then has to add text fields not present in the MIDI header and
possibly tidy up the abc note output.
The output of midi2abc is printed to the screen. To save it to a file, use the redirection
operator, (e.g. midi2abc -f file.mid > file.abc) or specify the output file using the -o
option.
Use only one or none of the options -u -gu, -b and -Q. Midi2abc normally converts the MIDI
time units into quantum units normally corresponding to the abc 1/16th note or 1/32nd
note. If none of these is present, the program will use the PPQN information in the MIDI
header to compute the suitable conversion factor. For most MIDI files on the web, it is
recommended to rely on the MIDI header information and not use any of the options other
than the formatting options.
The program will extract the time signature information from the MIDI file if it is
present. Otherwise it will assume 4/4 or you could specify it with -m. option.
If the tune has an anacrusis, you can use either the -ga or -xa option to estimate the its
length. Alternatively, you can specify its value using the -a option. The anacrusis is
specified in half unit lengths, where the unit length is defined by the L: field. For
example if L: 1/8, then a quarter note would be indicated by the value 4, (4 1/16 units).
OPTIONS
-a acbeats
where acbeats specifies the anacrusis in half unit lengths.
-xa extract the anacrusis from file by finding the first strong note
-ga guess the anacrusis by minimizing the number of ties across bars
-m time signature
time signature
-b bars
number of bars wanted in output
-Q tempo
tempo in quarter-notes per minute
-u pulses
Allows you to specify directly the number of midi pulses per abc time unit.
-ppu parts per abc unit length
Normally, the smallest note unit that midi2abc can extract is half the L: unit
length.This is called the quantum unit. Thus for L: 1/8, midi2abc can extract 1/16
notes but not 1/32 notes. You can change this by specifying -ppu 4 for example.
The number of parts should be a power of 2.
-aul denominator of abc unit length
Normally midi2abc chooses a unit length of 1/8 or 1/16 depending upon the time
signature. For time signatures smaller than 3/4 the L: 1/16 is used and for larger
time signatures L: 1/8 is used. You can specify the unit length to be used using
this parameter. Thus -aul 32 will cause midi2abc to use a unit length of 1/32 nd
note.
-gu Tells midi2abc to estimate the number of midi pulses per abc time unit from the
note duration or spacing in the MIDI file.
-gk Tells midi2abc to guess the key signature by minimizing the number of accidentals
even if the key signature is already specified in the MIDI file. By default the key
signature is the one specified in the MIDI file. If it is not specified, then the
program guesses the key signature by minimizing accidentals.
-k key key signature: -6 to 6 sharps.
-c channel
select only this midi channel.
-f infile
input file in midi format
-o output file
specifies the output abc file name.
-s do not discard very short notes.
-sr quantum units
do not notate a short rest smaller than the specified size after a note. If the
size (in quantum units) is zero, nothing is done. For larger values, the rest is
absorbed into the preceding note. In other words, the preceding note is lengthened
to include that rest.
-sum print a short summary of the input midi file.
-nb do not look for broken rhythms
-nt do not look for triplets
-obpl Print only one bar per line instead of 4. For complex music this improves the
readability and avoids some problems with some abc to postscript converters. This
option is deprecated.
-nogr (No note grouping.) Inserts a space between all notes. It makes a less pretty
postscript file but it is easier to edit.
-bpl nbars
Print nbars of music on every line followed by a backslash.
-bps nbars
When nbars have been printed (including those lines joined by a backslash
continuation) go to a new line (with no backslash).
-splitvoices
This parameter handles polyphonic chords by splitting an entire voice into multiple
voices. (A polyphonic chord is a chord composed of notes that do not start or end
at the same time.) Normally, midi2abc joins the longer notes to the notes in the
following chord using ties. Here is an example: [Bd-]d [Bd-]d|. This should be
separated into two voices ideally Bz Bz and d2 d2. However, the separation is not
unique. Bz d2 and d2 Bz are also ok.
-midigram
When this option appears, all other options are ignored and no abc file is
produced. Instead a list of all notes in the MIDI file are printed in a fixed
format. Each line represents a pair of MIDI note on/off event. The line contains
the on/off time of the note, its track number, channel number, midi pitch and midi
velocity. The last record indicates the duration of the MIDI file in MIDI pulse
units. The output is designed to go into a graphical user interface which will
produce a graphical representation (piano roll).
-mftext
When this option appears, all other options are ignored and no abc file is
produced. Instead a list of all the MIDI commands are printed. The output is
designed to go into a graphical user interface provided by runabc.tcl.
-mftextpulses
Same as -mftext except the time units is in midi pulses.
-title string
Replaces the default title field following T: with the given string.
-origin string
Adds an O: field with the given string.
-stats Extracts the characteristics of the given midi file. They include ntrks - the
number of tracks, ppqn - pulses per quarter note, timesig - time signature, keysig
- key signature, program - mapping between channel number and midi program, npulses
- length of the midi file in pulses, tempocmd - number of times the tempo has been
specified, pitchbends - number of pitchbends, pitchbendin - number of pitchbends in
each of the channels, programcmd - number of times the midi program has been
revised, progs and progsact - the programs used and the number of pulses these
programs used, drums - the drum numbers that were used, drumhits - the number of
times each of those drums were hit, pitches - the number of times the 11 pitch
classes (C C# etc...) were activated and a few other complex variables. These
characteristics are used in other applications such as midiexplorer. More details
are available in the file midi2abc-stats.txt included in the doc/ folder of the
abcmidi distribution package.
FEATURES
* The key is chosen so as to minimize the number of accidentals. Alternatively, the user
can specify the key numerically (a positive number is the number of sharps, a negative
number is minus the number of flats).
* Note length can be set by specifying the total number of bars or the tempo of the piece.
Alternatively the note length can be read from the file. However, by default it is
deduced in a heuristic manner from the inter-note distances. This means that you do not
have to use the MIDI clock as a metronome when playing in a tune from a keyboard.
* Barlines are automatically inserted. The user specifies the number of measures in the
anacrusis before the first barline and the time signature.
* The program can guess how the length of the anacrusis, either by looking for the first
strong note or minimizing the number of notes split by a tie across a barline.
* Where a note extends beyond a bar break, it is split into two tied notes.
* The output has 4 bars per line.
* Enough accidental signs are put in the music to ensure that no pitch errors occur if a
barline is added or deleted.
* The program attempts to group notes sensibly in each bar.
* Triplets and broken rhythm (a>b) are supported.
* Chords are identified.
* Text information from the original MIDI file is included as comments.
* The -c option can be used to select only 1 MIDI channel. Events on other channels are
ignored.
LIMITATIONS
midi2abc does not ...
* Supply tune title, composer or any other field apart from X: , K:, Q:, M: and L: - these
must be added by hand afterwards, though they may have been included in the text of the
MIDI file.
* Support duplets, quadruplets, other esoteric features.
* Support mid-tune key or time signature changes.
* Deduce repeats. The output is just the notes in the input file.
* Recover an abc tune as supplied to abc2midi. However, if you want to do this, "midi2abc
-xa -f file.mid" comes close.
SEE ALSO
abc2ps(1), abc2midi(1), abc2abc(1)
AUTHOR
James Allwright <J.R.Allwright@westminster.ac.uk>
SUPPORTED
Seymour Shlien <fy733@ncf.ca>
VERSION
This man page describes midi2abc version 2.91 from March 09 2008.
COPYRIGHT
Copyright 1999 James Allwright
midi2abc does not work correctly if lyrics are embedded in the same track as the notes. If
you are producing the MIDI file using abc2midi, use the -STFW option to ensure that the
lyrics are put in a separate track.
midi2abc is supplied "as is" without any warranty. It is free software and can be used,
copied, modified and distributed without fee under the terms of the GNU General Public
License.
1 January 2017 MIDI2ABC(1)