4 @chapter Converting to LilyPond format.
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.
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
31 Hackers who know about signal processing are invited to write a more
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.
38 @subsection Invoking midi2ly
41 midi2ly [OPTION]... MIDI-FLIE
44 @unnumberedsubsec Options
47 @item -b, --no-quantify,
48 Write exact durations, e.g.: `a4*385/384'.
50 Print lots of debugging stuff.
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".
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.
66 @item -s, --smallest=N,
67 Assume no shorter (reciprocal) durations than N.
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.
77 Report bugs to @email{bug-gnu-music@@gnu.org}.
80 Written by @email{Jan Nieuwenhuizen, janneke@@gnu.org}.
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.
91 @subsection Invoking etf2ly
95 etf2ly [OPTION]... ETF-FILE
98 Convert ETF to LilyPond.
100 @unnumberedsubsec Options
104 @item -o,--output=FILE
105 set output filename to FILE
113 Known: articulation scripts are buggy. Empty measures confuse etf2ly.
114 Report bugs to @email{bug-gnu-music@@gnu.org}.
116 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
119 Report bugs to @email{bug-gnu-music@@gnu.org}.
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}.
127 @subsection Invoking abc2ly
130 abc2ly [OPTION]... ABC-FILE
133 Convert ABC to LilyPond.
135 @unnumberedsubsec Options
139 @item -o,--output=FILE
140 set output filename to FILE
147 The ABC standard is not very "standard". For extended features
148 (eg. polyphonic music) different conventions exist.
151 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
154 Report bugs to @email{bug-gnu-music@@gnu.org}.
159 PMX is a Musixtex preprocessor written by Don Simons, see
160 @uref{http://www.gmd.de/Misc/Music/musixtex/software/pmx/}.
162 Report bugs to @email{bug-gnu-music@@gnu.org}.
164 @subsection Invoking pmx2ly
167 pmx2ly [OPTION]... PMX-FILE
170 Convert PMX to LilyPond.
172 @unnumberedsubsec Options
177 @item -o,--output=FILE
178 set output filename to FILE
183 Report bugs to @email{bug-gnu-music@@gnu.org}.
185 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
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
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
199 @subsection Invoking musedata2ly
202 musedata2ly [OPTION]... MUSEDATA-FILE
205 Convert Musedata to LilyPond.
207 @unnumberedsubsec Options
212 @item -o,--output=@var{file}
213 set output filename to @var{file}
216 @item -r,--ref=@var{reffile}
217 read background information from ref-file
221 Report bugs to @email{bug-gnu-music@@gnu.org}.
223 Written by @email{Han-Wen Nienhuys,hanwen@@cs.uu.nl}.
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.
233 @subsection Invoking mup2ly
236 mup2ly [OPTION]... MUP-FILE
239 Convert Mup to LilyPond.
241 @unnumberedsubsec Options
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
252 @item -o,--output=FILE
253 write output to @var{FILE}
257 print warranty and copyright. Mup2ly comes with absolutlely @strong{NO WARRANTY}.
263 Currently, only plain notes (pitches, durations), voices and staffs are
266 Written by @email{Jan Nieuwenhuizen,janneke@@gnu.org}, based on pmx2ly.
268 Report bugs to @email{bug-gnu-music@@gnu.org}.