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 There is a rudimentary facility for adding lilypond code to the ABC
 137 source file.  If you say:
 138
 139 @example
 140         %%LY voices \property Voice.noAutoBeaming=##t
 141 @end example
 142
 143 This will cause the text following the keyword ``voices'' to be inserted
 144 into the current voice of the lilypond output file.
 145
 146 Similarly:
 147
 148 @example
 149         %%LY slyrics more words
 150 @end example
 151
 152 will cause the text following the ``slyrics'' keyword to be inserted
 153 into the current line of lyrics.
 154
 155 @unnumberedsubsec Options
 156 @table @code
 157 @item   -h,--help
 158 this help
 159 @item  -o,--output=FILE
 160 set output filename to FILE
 161 @item  -v,--version
 162 version information
 163 @end table
 164
 165 @refbugs
 166
 167 The ABC standard is not very "standard". For extended features
 168 (eg. polyphonic music) different conventions exist.
 169
 170 Multiple tunes in one file cannot be converted.
 171
 172 ABC synchronizes words and notes at the beginning of a line; abc2ly does
 173 not.
 174
 175 abc2ly ignores the ABC beaming.
 176
 177 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 178
 179
 180 Report bugs to @email{bug-gnu-music@@gnu.org}.
 181
 182 @node pmx2ly
 183 @section pmx2ly
 184
 185 PMX is a Musixtex preprocessor written by Don Simons, see
 186 @uref{http://icking-music-archive.sunsite.dk/Misc/Music/musixtex/software/pmx/}.
 187
 188 Report bugs to @email{bug-gnu-music@@gnu.org}.
 189
 190 @subsection Invoking pmx2ly
 191
 192 @example
 193         pmx2ly [OPTION]... PMX-FILE
 194 @end example
 195
 196 Convert PMX to LilyPond.
 197
 198 @unnumberedsubsec Options
 199
 200 @table @code
 201 @item   -h,--help
 202 this help
 203 @item  -o,--output=FILE
 204 set output filename to FILE
 205 @item  -v,--version
 206 version information
 207 @end table
 208
 209 Report bugs to @email{bug-gnu-music@@gnu.org}.
 210
 211 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 212
 213
 214 @node musedata2ly
 215 @section musedata2ly
 216
 217 Musedata (@uref{http://www.musedata.org/}) is an electronic library of
 218 classical music scores, currently comprising about 800 composition
 219 dating from 1700 to 1825.  The music is encoded in so-called Musedata
 220 format
 221 (@uref{http://www.ccarh.org/publications/books/beyondmidi/online/musedata}).
 222 musedata2ly converts a set of musedata files to one .ly file, and will
 223 include a @code{\header} field if a @file{.ref} file is supplied
 224
 225 @subsection Invoking musedata2ly
 226
 227 @example
 228         musedata2ly [OPTION]... MUSEDATA-FILE
 229 @end example
 230
 231 Convert Musedata to LilyPond.
 232
 233 @unnumberedsubsec Options
 234
 235 @table @code
 236 @item   -h,--help
 237 print help
 238 @item  -o,--output=@var{file}
 239 set output filename to @var{file}
 240 @item  -v,--version
 241 version information
 242 @item  -r,--ref=@var{reffile}
 243  read background information from ref-file
 244 @var{REFFILE}
 245 @end table
 246
 247 Report bugs to @email{bug-gnu-music@@gnu.org}.
 248
 249 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 250
 251
 252 @node mup2ly
 253 @section mup2ly
 254
 255 MUP (Music Publisher) is a shareware music notation program by Arkkra
 256 Enterprises.  It is also the name of the input format.  Mup2ly will
 257 convert part of a Mup file to a ready-to-use LilyPond file.
 258
 259 @subsection Invoking mup2ly
 260
 261 @example
 262         mup2ly [OPTION]... MUP-FILE
 263 @end example
 264
 265 Convert Mup to LilyPond.
 266
 267 @unnumberedsubsec Options
 268
 269 @table @code
 270 @item   -d,--debug
 271 show what constructs are not converted, but skipped.
 272 @item D, --define=@var{NAME}[=@code{EXP}]
 273 define macro @var{NAME} with opt expansion @code{EXP}
 274 @item   -E,--pre-process
 275 only run the pre-processor
 276 @item   -h,--help
 277 print help
 278 @item  -o,--output=FILE
 279 write output to @var{FILE}
 280 @item  -v,--version
 281 version information
 282 @item  -w,--warranty
 283 print warranty and copyright.  Mup2ly comes with absolutlely @strong{NO WARRANTY}.
 284 @end table
 285
 286
 287 @refbugs
 288
 289 Currently, only plain notes (pitches, durations), voices and staffs are
 290 converted.
 291
 292 Written by @email{Jan Nieuwenhuizen,janneke@@gnu.org}, based on pmx2ly.
 293
 294 Report bugs to @email{bug-gnu-music@@gnu.org}.
 295
 296
 297