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
 140 @node pmx2ly
 141 @section pmx2ly
 142
 143 PMX is a Musixtex preprocessor written by Don Simons, see
 144 @uref{http://www.gmd.de/Misc/Music/musixtex/software/pmx/}.
 145
 146 Report bugs to @email{bug-gnu-music@@gnu.org}.
 147
 148 @example
 149         pmx2ly [OPTION]... PMX-FILE
 150 @end example
 151
 152 Convert PMX to LilyPond.
 153
 154 Options:
 155 @table @code
 156 @item   -h,--help
 157 this help
 158 @item  -o,--output=FILE
 159 set output filename to FILE
 160 @item  -v,--version
 161 version information
 162 @end table
 163
 164
 165 @node musedata2ly
 166 @section musedata2ly
 167
 168 PMX is a Musixtex preprocessor written by Don Simons, see
 169 @uref{http://www.gmd.de/Misc/Music/musixtex/software/pmx/}.
 170
 171 Report bugs to @email{bug-gnu-music@@gnu.org}.
 172
 173 @example
 174         musedata2ly [OPTION]... MUSEDATA-FILE
 175 @end example
 176
 177 Convert Musedata to LilyPond. Musedata (@uref{http://www.musedata.org/})
 178 is an electronic library of classical music scores, currently comprising
 179 about 800 composition dating from 1700 to 1825.  The music is encoded in
 180 so-called Musedata format
 181 (@uref{http://www.ccarh.org/publications/books/beyondmidi/online/musedata}).
 182 musedata2ly converts a set of musedata files to one .ly file, and will
 183 include a \header field if a .ref file is supplied
 184
 185 Report bugs to @email{bug-gnu-music@@gnu.org}.
 186
 187 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
 188
 189
 190 Options:
 191 @table @code
 192 @item   -h,--help
 193 this help
 194 @item  -o,--output=@var{file}
 195 set output filename to @var{file}
 196 @item  -v,--version
 197 version information
 198 @item  -r,--ref=@var{reffile}
 199  read background information from ref-file
 200 @var{REFFILE}
 201 @end table
 202
 203
 204