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