abc2midi

ABC2MIDI(1)                 General Commands Manual                ABC2MIDI(1)



NAME
       abc2midi - converts abc file to MIDI file(s)

SYNOPSIS
       abc2midi infile [refnum] [-c] [-v] [-ver] [-t] [-n limit] [-RS]
       [-quiet] [-Q tempo] [-NFNP] [-OCC] [-o outfile]

DESCRIPTION
        The default action is to write a MIDI file for each abc tune
        with the filename <stem>N.mid, where <stem> is the filestem
        of the abc file and N is the tune reference number. If the -o
        option is used, only one file is written. This is the tune
        specified by the reference number or, if no reference number
        is given, the first tune in the file.

OPTIONS
       refnum process the tune with reference number refnum

       -c     selects checking only

       -v     selects verbose option

       -ver   prints version number and exits

       -t     selects filenames derived from tune titles

       -RS    use 3:1 instead of 2:1 for broken rhythms

       -quiet Suppresses some commong warnings.

       -n  X  limits the length of the file name stem to X characters

       -Q  tempo
              sets the default tempo in quarter notes per minute if it was not
              specified in the abc header.

       -NFNP  Ignore any dynamic indications !f! !ff! etc.

       -OCC   Accept old chord convention (eg +D2G2+ instead of [DG]2).

       -o outfile
              write output to outfile

FEATURES
       * Broken rythms (>, <), chords, n-tuples, slurring, ties, staccatto
       notes, repeats, in-tune tempo/length/time signature changes are all
       supported.

       * R:hornpipe or r:hornpipe is recognized and note timings are adjusted
       to give a broken rhythm (ab is converted to a>b).

       * Most errors in the abc input will generate a suitable error message
       in the output and the converter keeps going.

       * Comments and text fields in the abc source are converted to text
       events in the MIDI output

       * If guitar chords are present, they are used to generate an
       accompaniment in the MIDI output.

       * If there are mis-matched repeat signs in the abc, the program
       attempts to fix them. However, it will not attempt this if a multi-part
       tune description has been used or if multiple voices are in use.

       * Karaoke MIDI files can be generated by using the w: field to include
       lyrics.

       * Nonnumeric voice id's, eg. V: soprano, as proposed for the new abc
       standard is accepted.

       * Invisible rests specified by x are treated the same way as normal
       rests (z).

       * Decorations may be indicated using either the deprecated notation
       (eg. !fermata!) or the standard version 2.0 notation (eg. +fermata+).

LIMITATIONS
       * No field is inherited from above the X: field of the tune.



ABC SYNTAX EXTENSIONS
       * There are some extensions to the abc syntax of the form

       %%MIDI channel n

       These control channel and program selection, transposing and various
       other features of abc2midi.

       Each of these should appear on a line by itself. All of them are
       allowed within the abc tune body. By using these in combination with
       the part notation, one can, for example, play a part transposed or in a
       different key.

       The idea behind this syntax is that other programs will treat it as a
       comment and ignore it.

       %%MIDI channel n

       selects melody channel n (in the range 1-16).

       %%MIDI program [c] n

       selects program n (in the range 1-128) on channel c. If c is not given,
       the program is selected on the current melody channel. Most modern tone
       generators follow the General MIDI standard which defines the
       instrument type for each program number.

       %%MIDI beat a b c n

       controls the way note velocities are selected. The first note in a bar
       has velocity a. Other "strong" notes have velocity b and all the rest
       have velocity c. a, b and c must be in the range 0-128. The parameter n
       determines which notes are "strong". If the time signature is x/y, then
       each note is given a position number k = 0, 1, 2 .. x-1 within each
       bar. Note that the units for n are not the unit note length. If k is a
       multiple of n, then the note is "strong". The volume specifiers !ppp!
       to !fff! are equivalent to the following :

       !ppp! = %%MIDI beat 30 20 10 1
       !pp!  = %%MIDI beat 45 35 20 1
       !p!   = %%MIDI beat 60 50 35 1
       !mp!  = %%MIDI beat 75 65 50 1
       !mf!  = %%MIDI beat 90 80 65 1
       !f!   = %%MIDI beat 105 95 80 1
       !ff!  = %%MIDI beat 120 110 95 1
       !fff! = %%MIDI beat 127 125 110 1


       %%MIDI beatmod n

       Increments by n (or decrements if n is negative) the velocities a, b
       and c described above. The instructions !crescendo(! and !crescendo)!
       are equivalent to inserting a %%MIDI beatmod 15 whereever they occur.
       (Alternatively you can use !<(! and !<)!.) Similarly the instructions
       !diminuendo(! and !diminuendo)! are equivalent to %%MIDI beatmod -15.


       %%MIDI deltaloudness n

       where n is a small positive number.  By default the crescendo and
       diminuendo instructions modify the beat variables a, b, and c by 15
       velocity units. This instruction allows you to set this default to
       value n.


       %%MIDI nobeataccents

       For instruments such as church organ that have no greatly emphasized
       beat notes, using this will force use of the 'b' velocity (see %%MIDI
       beat) for every note irrespective of position in the bar.  This allows
       dynamics (ff, f, etc) to be used in the normal way.

       %%MIDI beataccents

       Revert to emphasizing notes the the usual way. (default)


       %%MIDI beatstring <string of f, m and p>

       This provides an alternative way of specifying where the strong and
       weak stresses fall within a bar. 'f' means velocity a (normally
       strong), 'm' means velocity b (medium velocity) and 'p' means velocity
       c (soft velocity).  For example, if the time signature is 7/8 with
       stresses on the first, fourth and sixth notes in the bar, we could use
       the following

       %%MIDI beatstring fppmpmp

       %%MIDI transpose n

       transposes the output by the specified number of semitones. n may be
       positive or negative.

       %%MIDI rtranspose n

       Relative transpose by the specified number of semitones. i.e.  %%MIDI
       transpose a followed by %%MIDI rtranspose b results in a transposition
       of a+b. %%MIDI transpose b will result in a transposition of b
       semitones, regardless of any previous transposition.

       %%MIDI c n

       specifies the MIDI pitch which corresponds to c. The default is 60.
       This number should normally be a multiple of 12.

       %%MIDI grace a/b

       sets the fraction of the next note that grace notes will take up. a
       must be between 1 and b-1. The grace notes may not sound natural in
       this approach, since the length of the individual grace notes vary with
       the complexity of the grace and the length of the following note. A
       different approach (which is now the default) assumes that the grace
       notes always have a fixed duration.  To use the other approach you
       would specify,

       %%MIDI gracedivider b

       where b specifies how many parts to divide the unit length specified by
       the L: field command. For example if b = 4 and L: = 1/8, then every
       grace note would be 1/(8*4) or a 32nd note. Time would be stolen from
       the note to which the grace notes are applied. If that note is not long
       enough to handle the grace then the grace notes would be assigned 0
       duration.




       %%MIDI chordname name n1 n2 n3 n4 n5 n6

       Defines how to play a guitar chord called "name". n1 is usually 0 and
       n2, n3 to n6 give the pitches of the other notes in semitones relative
       to the root note. There may be fewer than 6 notes in the chord, but not
       more.If "name" is already defined, this command re-defines it. Unlike
       most other commands, chordname definitions stay in effect from where
       they are defined to the end of the abc file. The following illustrates
       how m, 7, m7 and maj7 could be set up if they were not already defined.

       %%MIDI chordname m 0 3 7
       %%MIDI chordname 7 0 4 7 10
       %%MIDI chordname m7 0 3 7 10
       %%MIDI chordname maj7 0 4 7 11

       %%MIDI gchord string

       sets up how guitar chords are generated. The string is a sequence made
       of of z's, c's  f's and b's for rests, chords, fundamental and
       fundamental plus chord notes respectively.  This specifies how each bar
       is to be played.  An optional length is allowed to follow the z's, c's
       f's and b's  e.g. czf2zf3.  If the abc contains guitar chords, then
       abc2midi automatically adds chords and fundamentals after encountering
       the first guitar chord. It keeps using that chord until a new chord is
       specified in the abc. Whenever the M: field is encountered in the abc,
       an appropriate default string is set :

       For 2/4 or 4/4 time default is equivalent to : %%MIDI gchord fzczfzcz

       For 3/4 time default is equivalent to : %%MIDI gchord fzczcz

       For 6/8 time default is equivalent to : %%MIDI gchord fzcfzc

       For 9/8 time default is equivalent to : %%MIDI gchord fzcfzcfzc

       The gchord command has been extended to allow you to play the
       individual notes comprising the guitar chord. This allows you to play
       broken chords or arpeggios. The new codes g,h,i,j, G,H,I,J reference
       the individual notes starting from the lowest note of the chord (not
       necessarily the root in the case of inversions). For example for the C
       major chord, g refers to C, h refers to E and i refers to G. For a
       gchord command such as,

       %%MIDI gchord ghih

       Abc2midi will arpeggiate the C major guitar chord to CEGE. The upper
       case letters G,H,I, and J refer to the same notes except they are
       transposed down one octave. Note for the first inversion of the C major
       chord (indicated by "C/E"), E would be the lowest note so g would
       reference the note E.

       Like other gchord codes, you may append a numeral indicating the
       duration of the note. The same rules apply as before.  You can use any
       combination of the gchord codes, (fcbghijGHIJz).



       %%MIDI chordprog n

       Sets the MIDI instrument for the chords to be n.

       %%MIDI bassprog n

       Sets the MIDI instrument for the bass notes to be n.

       %%MIDI chordvol n

       Sets the volume (velocity) of the chord notes at n.

       %%MIDI bassvol n

       Sets the volume (velocity) of the bass notes at n. There is no
       corresponding melodyvol command since there are 3 velocity values for
       melody, set using the beat command.

       %%MIDI gchordon

       Turns on guitar chords (they are turned on by default at the start of a
       tune).

       %%MIDI gchordoff

       Turns off guitar chords.

       %%MIDI droneon

       Turns on a continuous drone (used in bagpipe music) consisting of two
       notes. By default the notes are A, and A,, played on a bassoon at a
       velocity of 80. This can be configured by the %%MIDI drone command
       described below.

       %%MIDI droneoff

       Turns off the continous drone.

       %%MIDI drone n1 n2 n3 n4 n5

       Sets the drone parameters where n1 is the MIDI program, n2 and n3
       specify the MIDI pitches of the two notes in the chord, and n4 and n5
       specify the MIDI velocities of the two notes.  If you do not set these
       parameters they are by default 70 45 33 80 80. A value of zero or less
       indicates that the setting of this parameter should be left as it is.

       %%MIDI drum string [drum programs] [drum velocities]

       This sets up a drum pattern. The string determines when there is a drum
       beat and the drum program values determine what each drum strike sounds
       like.

       e.g. %%MIDI drum d2zdd 35 38 38  100 50 50

       The string may contain 'd' for a drum strike or 'z' for a rest. By
       default a voice starts with no drum pattern and '%%MIDI drumon' is
       needed to enable the drumming. The drum pattern is repeated during each
       bar until '%%MIDI drumoff' is encountered. The %%MIDI drum command may
       be used within a tune to change the drum pattern.  This command places
       the drum sounds on channel 10 and assumes your tone generator complies
       with the General Midi standard - if it does not, then you may hear
       tones instead of drum sounds.

       In both the gchord and drum commands, the standard note length of a
       single note f,c,z or d is not set by the L: command. Instead it is
       adjusted so that the entire gchord string or drum string fits exactly
       into one bar. In other words the duration of each note is divided by
       the total duration of the string. This means that, for example, the
       drum string "dd" is equivalent to drum string "d4d4".  You cannot
       currently specify fractions directly (eg. C3/2) as done in the body of
       the music, but it is still possible to express complex rhythms. For
       example, to indicate a rhythm such as (3ddd d/d/d/d, you would write
       the string "d4d4d4d3d3d3d3".



       With version 1.54 Dec 4 2004 of abc2midi, notes in chords (eg. [FAc])
       are not played in the same instant but offsetted and shortened by 10
       MIDI time units. Thus the first note in the chord (eg. F) is played for
       the full indicated time, the second note (eg. A) starts 10 MIDI units
       later and is shortened by the same amount and the third note starts
       another 10 MIDI units later and is shortened by another 10 units. This
       introduces an "expressivo" option and avoids the heavy attack. (This
       does not apply to gchords or multivoiced chords.) The amount of the
       delay and shortening may be configured by the MIDI command


       %%MIDI chordattack n


       where n is a small number. If n is zero, then abc2midi should behave as
       in earlier versions. The delay n is in MIDI time units where there are
       480 units in a quarter note beat. The program may not run correctly if
       n is too large and there are short chords.


       %%MIDI randomchordattack n

       Like above except that the delay is a random variable uniformly
       distributed between 0 and n-1.


       %%MIDI trim x/y

       where x and y are two numbers. This command controls the articulation
       of notes and chords by placing silent gaps between the notes.  The
       length of these gaps is determined by x/y and the unit length specified
       by the L: command. These gaps are produced by shortening the notes by
       the same amount.  If the note is already shorter than the specified
       gap, then the gap is set to half the length of the note.  The fraction
       x/y indicates a note duration in the same manner as specified in the
       abc file.  The actual duration is based on the unit length specified by
       the L: field command. It is recommended that x/y be a fraction close to
       zero. Note trimming is disabled inside slurs as specified by
       parentheses. You can turn off all note trimming by setting x to 0, eg
       0/1. By default, note trimming is turned off at the beginning of a tune
       or voice command.



       %%MIDI drummap note midipitch

       Please see abcguide.txt.



COMPATIBILITY WITH DRAFT STANDARD 2.0
       The proposed standard introduces a new copyright field using the syntax


       %%abc-copyright (c) Copyright John Smith 2003


       Abc2midi now inserts this in the MIDI file in the form of a metatext
       copyright tag. Changes were made to the event_specific function in
       store.c to process the copyright information. It is also copied into
       the Karaoke track (if it is created) as as @T field.


SEE ALSO
       abc2ps(1), midi2abc(1), yaps(1).

AUTHOR
       James Allwright <J.R.Allwright@westminster.ac.uk>

SUPPORTED
        by Seymour Shlien <seymour.shlien@crc.ca>

VERSION
       This man page describes abc2midi version 1.85  June 25 2006.

COPYRIGHT
       Copyright 1999 James Allwright

       abc2midi 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.

       More complete documentation may be found in abcguide.txt which comes
       with the abcMIDI distribution.



                                 25 June 2006                      ABC2MIDI(1)