Documentation/user/convertors.itely

   1 @c -*-texinfo-*-
   2
   3 @node Conversion tools
   4 @chapter Converting to LilyPond format.
   5
   6
   7 @menu
   8 * midi2ly::
   9 * etf2ly::
  10 * abc2ly::
  11 * pmx2ly::
  12 * musedata2ly::
  13 @end menu
  14
  15 @node midi2ly
  16 @section midi2ly
  17
  18 Midi2ly translates a MIDI input file to a LilyPond source file. MIDI
  19 (Music Instrument Digital Interface) is a standard for digital
  20 instruments: it specifies cabling, a serial protocol and a file format.
  21
  22 It is possible to record a MIDI file using a digital keyboard, and then
  23 convert it to @file{.ly}. However, human players can not rhythmically
  24 exact enough to make a MIDI to .ly conversion trivial.  midi2ly tries to
  25 compensate for these timing errors, but is not very good at this. It is
  26 therefore not recommended to use midi2ly for human-generated midi
  27 files. Correcting the quantization mistakes of the human player takes a
  28 lot of time.
  29
  30 Hackers who know about signal processing are invited to write  a more
  31 robust midi2ly.
  32
  33 MIDI is also a de facto standard format for exporting music from other
  34 programs, so this capability may come in useful when you want to import
  35 files from a program that has no convertor for its native format.
  36
  37 @subsection Invoking midi2ly
  38
  39 @example
  40         midi2ly [options] midi-file
  41 @end example
  42
  43 @unnumberedsec Options
  44
  45 @table @code
  46 @item -b, --no-quantify,
  47     Write exact durations, e.g.: `a4*385/384'.
  48 @item -D, --debug,
  49     Print lots of debugging stuff.
  50 @item -h, --help,
  51     Show a summary of usage.
  52 @item -I, --include=@file{DIR},
  53     Add DIR to search path.
  54 @item -k, --key=ACC[:MINOR],
  55     Set default key.  ACC > 0 sets number of sharps; ACC < 0 sets number
  56     of flats.  A minor key is indicated by ":1".
  57 @item -n, --no-silly,
  58     Assume no plets or double dots, assume smallest (reciprocal) duration 16.
  59 @item -o, --output=@file{FILE},
  60     Set @file{FILE} as default output.
  61 @item -p, --no-plets,
  62     Assume no plets.
  63 @item -q, --quiet,
  64     Be quiet.
  65 @item -s, --smallest=N,
  66     Assume no shorter (reciprocal) durations than N.
  67 @item -v, --verbose,
  68     Be verbose.
  69 @item -w, --warranty,
  70     Show the warranty with which midi2ly comes. (It comes with @strong{NO WARRANTY}!)
  71 @item -x, --no-double-dots,
  72     Assume no double dotted notes.
  73 @end table
  74
  75 @node etf2ly
  76 @section etf2ly
  77
  78
  79 ETF (Enigma Transport Format) is a format used by Coda Music
  80 Technology's Finale product. This program will convert part of an ETF
  81 file to a ready-to-use lilypond file.
  82
  83 @subsection Invoking etf2ly
  84 Usage:
  85
  86 @example
  87         etf2ly [OPTION]... ETF-FILE
  88 @end example
  89
  90 Convert ETF to LilyPond.
  91
  92 Options:
  93 @table @code
  94 @item   -h,--help
  95 this help
  96 @item  -o,--output=FILE
  97 set output filename to FILE
  98 @item  -v,--version
  99 version information
 100 @end table
 101
 102
 103 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 104
 105
 106 @subsection Bugs
 107
 108 Known: articulation scripts are buggy.  Empty measures confuse etf2ly.
 109 Report bugs to @email{bug-gnu-music@@gnu.org}.
 110
 111 @node abc2ly
 112 @section abc2ly
 113
 114 ABC is a fairly simple ASCII based format. It is described at
 115 @uref{http://www.gre.ac.uk/~c.walshaw/abc2mtex/abc.txt}.
 116
 117
 118 @example
 119         abc2ly [OPTION]... ABC-FILE
 120 @end example
 121
 122 Convert ABC to LilyPond.
 123
 124 Options:
 125 @table @code
 126 @item   -h,--help
 127 this help
 128 @item  -o,--output=FILE
 129 set output filename to FILE
 130 @item  -v,--version
 131 version information
 132 @end table
 133
 134 @subsection Bugs
 135
 136 The ABC standard is not very "standard". For extended features
 137 (eg. polyphonic music) different conventions exist.
 138
 139 [TODO: describe limitations]
 140
 141
 142 @node pmx2ly
 143 @section pmx2ly
 144
 145 PMX is a Musixtex preprocessor written by Don Simons, see
 146 @uref{http://www.gmd.de/Misc/Music/musixtex/software/pmx/}.
 147
 148 Report bugs to @email{bug-gnu-music@@gnu.org}.
 149
 150 @example
 151         pmx2ly [OPTION]... PMX-FILE
 152 @end example
 153
 154 Convert PMX to LilyPond.
 155
 156 Options:
 157 @table @code
 158 @item   -h,--help
 159 this help
 160 @item  -o,--output=FILE
 161 set output filename to FILE
 162 @item  -v,--version
 163 version information
 164 @end table
 165
 166
 167 @node musedata2ly
 168 @section musedata2ly
 169
 170 PMX is a Musixtex preprocessor written by Don Simons, see
 171 @uref{http://www.gmd.de/Misc/Music/musixtex/software/pmx/}.
 172
 173 Report bugs to @email{bug-gnu-music@@gnu.org}.
 174
 175 @example
 176         musedata2ly [OPTION]... MUSEDATA-FILE
 177 @end example
 178
 179 Convert Musedata to LilyPond. Musedata (@uref{http://www.musedata.org/})
 180 is an electronic library of classical music scores, currently comprising
 181 about 800 composition dating from 1700 to 1825.  The music is encoded in
 182 so-called Musedata format
 183 (@uref{http://www.ccarh.org/publications/books/beyondmidi/online/musedata}).
 184 musedata2ly converts a set of musedata files to one .ly file, and will
 185 include a \header field if a .ref file is supplied
 186
 187 Report bugs to @email{bug-gnu-music@@gnu.org}.
 188
 189 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 190
 191
 192 Options:
 193 @table @code
 194 @item   -h,--help
 195 this help
 196 @item  -o,--output=@var{file}
 197 set output filename to @var{file}
 198 @item  -v,--version
 199 version information
 200 @item  -r,--ref=@var{reffile}
 201  read background information from ref-file
 202 @var{REFFILE}
 203 @end table
 204
 205
 206