Documentation/user/converters.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 * mup2ly::
  14 @end menu
  15
  16 @node midi2ly
  17 @section midi2ly
  18
  19 Midi2ly translates a MIDI input file to a LilyPond source file. MIDI
  20 (Music Instrument Digital Interface) is a standard for digital
  21 instruments: it specifies cabling, a serial protocol and a file format.
  22
  23 The MIDI file format is a de facto standard format for exporting music
  24 from other programs, so this capability may come in useful when you want
  25 to import files from a program that has no converter for its native
  26 format.
  27
  28 It is possible to record a MIDI file using a digital keyboard, and then
  29 convert it to @file{.ly}. However, human players can not rhythmically
  30 exact enough to make a MIDI to .ly conversion trivial.  midi2ly tries to
  31 compensate for these timing errors, but is not very good at this. It is
  32 therefore not recommended to use midi2ly for human-generated midi
  33 files. Correcting the quantization mistakes of the human player takes a
  34 lot of time.
  35
  36 Hackers who know about signal processing are invited to write  a more
  37 robust midi2ly.
  38
  39 @subsection Invoking midi2ly
  40
  41 @example
  42         midi2ly [OPTION]... MIDI-FLIE
  43 @end example
  44
  45 @unnumberedsubsec Options
  46
  47 @table @code
  48 @item -b, --no-quantify,
  49     Write exact durations, e.g.: `a4*385/384'.
  50 @item -D, --debug,
  51     Print lots of debugging stuff.
  52 @item -h, --help,
  53     Show a summary of usage.
  54 @item -I, --include=@file{DIR},
  55     Add DIR to search path.
  56 @item -k, --key=ACC[:MINOR],
  57     Set default key.  ACC > 0 sets number of sharps; ACC < 0 sets number
  58     of flats.  A minor key is indicated by ":1".
  59 @item -n, --no-silly,
  60     Assume no plets or double dots, assume smallest (reciprocal) duration 16.
  61 @item -o, --output=@file{FILE},
  62     Set @file{FILE} as default output.
  63 @item -p, --no-plets,
  64     Assume no plets.
  65 @item -q, --quiet,
  66     Be quiet.
  67 @item -s, --smallest=N,
  68     Assume no shorter (reciprocal) durations than N.
  69 @item -v, --verbose,
  70     Be verbose.
  71 @item -w, --warranty,
  72     Show the warranty with which midi2ly comes. (It comes with @strong{NO WARRANTY}!)
  73 @item -x, --no-double-dots,
  74     Assume no double dotted notes.
  75 @end table
  76
  77
  78 Report bugs to @email{bug-gnu-music@@gnu.org}.
  79
  80
  81 Written by @email{Jan Nieuwenhuizen, janneke@@gnu.org}.
  82
  83
  84 @node etf2ly
  85 @section etf2ly
  86
  87
  88 ETF (Enigma Transport Format) is a format used by Coda Music
  89 Technology's Finale product. This program will convert part of an ETF
  90 file to a ready-to-use LilyPond file.
  91
  92 @subsection Invoking etf2ly
  93 Usage:
  94
  95 @example
  96         etf2ly [OPTION]... ETF-FILE
  97 @end example
  98
  99 Convert ETF to LilyPond.
 100
 101 @unnumberedsubsec Options
 102 @table @code
 103 @item   -h,--help
 104 this help
 105 @item  -o,--output=FILE
 106 set output filename to FILE
 107 @item  -v,--version
 108 version information
 109 @end table
 110
 111
 112 @refbugs
 113
 114 Known: articulation scripts are buggy.  Empty measures confuse etf2ly.
 115 Report bugs to @email{bug-gnu-music@@gnu.org}.
 116
 117 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 118
 119
 120 Report bugs to @email{bug-gnu-music@@gnu.org}.
 121
 122 @node abc2ly
 123 @section abc2ly
 124
 125 ABC is a fairly simple ASCII based format. It is described at
 126 @uref{http://www.gre.ac.uk/~c.walshaw/abc2mtex/abc.txt}.
 127
 128 @subsection Invoking abc2ly
 129
 130 @example
 131         abc2ly [OPTION]... ABC-FILE
 132 @end example
 133
 134 Convert ABC to LilyPond.
 135
 136 @unnumberedsubsec Options
 137 @table @code
 138 @item   -h,--help
 139 this help
 140 @item  -o,--output=FILE
 141 set output filename to FILE
 142 @item  -v,--version
 143 version information
 144 @end table
 145
 146 @refbugs
 147
 148 The ABC standard is not very "standard". For extended features
 149 (eg. polyphonic music) different conventions exist.
 150
 151
 152 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 153
 154
 155 Report bugs to @email{bug-gnu-music@@gnu.org}.
 156
 157 @node pmx2ly
 158 @section pmx2ly
 159
 160 PMX is a Musixtex preprocessor written by Don Simons, see
 161 @uref{http://icking-music-archive.sunsite.dk/Misc/Music/musixtex/software/pmx/}.
 162
 163 Report bugs to @email{bug-gnu-music@@gnu.org}.
 164
 165 @subsection Invoking pmx2ly
 166
 167 @example
 168         pmx2ly [OPTION]... PMX-FILE
 169 @end example
 170
 171 Convert PMX to LilyPond.
 172
 173 @unnumberedsubsec Options
 174
 175 @table @code
 176 @item   -h,--help
 177 this help
 178 @item  -o,--output=FILE
 179 set output filename to FILE
 180 @item  -v,--version
 181 version information
 182 @end table
 183
 184 Report bugs to @email{bug-gnu-music@@gnu.org}.
 185
 186 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 187
 188
 189 @node musedata2ly
 190 @section musedata2ly
 191
 192 Musedata (@uref{http://www.musedata.org/}) is an electronic library of
 193 classical music scores, currently comprising about 800 composition
 194 dating from 1700 to 1825.  The music is encoded in so-called Musedata
 195 format
 196 (@uref{http://www.ccarh.org/publications/books/beyondmidi/online/musedata}).
 197 musedata2ly converts a set of musedata files to one .ly file, and will
 198 include a @code{\header} field if a @file{.ref} file is supplied
 199
 200 @subsection Invoking musedata2ly
 201
 202 @example
 203         musedata2ly [OPTION]... MUSEDATA-FILE
 204 @end example
 205
 206 Convert Musedata to LilyPond.
 207
 208 @unnumberedsubsec Options
 209
 210 @table @code
 211 @item   -h,--help
 212 print help
 213 @item  -o,--output=@var{file}
 214 set output filename to @var{file}
 215 @item  -v,--version
 216 version information
 217 @item  -r,--ref=@var{reffile}
 218  read background information from ref-file
 219 @var{REFFILE}
 220 @end table
 221
 222 Report bugs to @email{bug-gnu-music@@gnu.org}.
 223
 224 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 225
 226
 227 @node mup2ly
 228 @section mup2ly
 229
 230 MUP (Music Publisher) is a shareware music notation program by Arkkra
 231 Enterprises.  It is also the name of the input format.  Mup2ly will
 232 convert part of a Mup file to a ready-to-use LilyPond file.
 233
 234 @subsection Invoking mup2ly
 235
 236 @example
 237         mup2ly [OPTION]... MUP-FILE
 238 @end example
 239
 240 Convert Mup to LilyPond.
 241
 242 @unnumberedsubsec Options
 243
 244 @table @code
 245 @item   -d,--debug
 246 show what constructs are not converted, but skipped.
 247 @item D, --define=@var{NAME}[=@code{EXP}]
 248 define macro @var{NAME} with opt expansion @code{EXP}
 249 @item   -E,--pre-process
 250 only run the pre-processor
 251 @item   -h,--help
 252 print help
 253 @item  -o,--output=FILE
 254 write output to @var{FILE}
 255 @item  -v,--version
 256 version information
 257 @item  -w,--warranty
 258 print warranty and copyright.  Mup2ly comes with absolutlely @strong{NO WARRANTY}.
 259 @end table
 260
 261
 262 @refbugs
 263
 264 Currently, only plain notes (pitches, durations), voices and staffs are
 265 converted.
 266
 267 Written by @email{Jan Nieuwenhuizen,janneke@@gnu.org}, based on pmx2ly.
 268
 269 Report bugs to @email{bug-gnu-music@@gnu.org}.
 270
 271
 272