chapter documents the tools included in the distribution to do so.
There are other tools that produce LilyPond input, for example GUI
sequencers and XML converters. Refer to the
-@uref{website,http://lilypond.org} for more details.
+@uref{http://lilypond.org,website} for more details.
@menu
-* Invoking convert-ly:: Older LilyPond versions.
-* Invoking midi2ly:: Importing MIDI.
-* Invoking etf2ly:: Importing Finale.
-* Invoking abc2ly:: Importing ABC.
-* Invoking pmx2ly:: Importing PMX.
-* Invoking musedata2ly:: Importing Musedata.
-* Invoking mup2ly:: Importing MUP.
+* Invoking convert-ly:: Older LilyPond versions.
+* Invoking midi2ly:: Importing MIDI.
+* Invoking etf2ly:: Importing Finale.
+* Invoking abc2ly:: Importing ABC.
+* Invoking pmx2ly:: Importing PMX.
+* Invoking musedata2ly:: Importing Musedata.
+* Invoking mup2ly:: Importing MUP.
@end menu
@section Invoking convert-ly
Convert-ly sequentially applies different conversions to upgrade a
-Lilypond input file. It uses @code{\version} statements in the file to
-detect the old version number. For example, to upgrade all lilypond
+LilyPond input file. It uses @code{\version} statements in the file to
+detect the old version number. For example, to upgrade all LilyPond
files in the current directory and its subdirectories, use
@example
convert-ly -e --to=1.3.150 `find . -name '*.ly' -print`
Set the goal version of the conversion. It defaults to the latest
available version.
@item -h, --help
- Print usage help
+ Print usage help.
@end table
format.
@file{midi2ly} will convert tracks into @internalsref{Staff} and
-channels into @internalsref{Voice} contexts.
+channels into @internalsref{Voice} contexts. Relative mode is used
+for pitches, durations are only written when necessary.
It is possible to record a MIDI file using a digital keyboard, and then
convert it to @file{.ly}. However, human players are not rhythmically
The following options are supported by midi2ly:
@table @code
-@item -b, --no-quantify,
- Write exact durations, e.g.: `a4*385/384'.
-@item -D, --debug,
- Print lots of debugging stuff.
-@item -h, --help,
- Show a summary of usage.
-@item -I, --include=@var{dir},
- Add @var{dir} to search path.
-@item -k, --key=@var{acc}[:@var{minor}],
+@item -a, --absolute-pitches
+ Print absolute pitches.
+@item -d, --duration-quant=@var{DUR}
+ Quantise note durations on @var{DUR}.
+@item -e, --explicit-durations
+ Print explicit durations.
+@item -h,--help
+ Show summary of usage.
+@item -k, --key=@var{acc}[:@var{minor}]
Set default key. @var{acc} > 0 sets number of sharps; @var{acc} < 0
-sets number
- of flats. A minor key is indicated by ":1".
-@item -n, --no-silly,
- Assume no plets or double dots, assume smallest (reciprocal) duration 16.
-@item -o, --output=@var{file},
- Set @var{file} as default output.
-@item -p, --no-plets,
- Assume no plets.
-@item -q, --quiet,
- Be quiet.
-@item -s, --smallest=N,
- Assume no shorter (reciprocal) durations than N.
-@item -v, --verbose,
+ sets number of flats. A minor key is indicated by ":1".
+@item -o, --output=@var{file}
+ Write output to @var{file}.
+@item -s, --start-quant=@var{DUR}
+ Quantise note starts on DUR.
+@item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
+ Allow tuplet durations @var{DUR}*@var{NUM}/@var{DEN}.
+@item -V, --verbose
Be verbose.
-@item -w, --warranty,
- Show the warranty with which midi2ly comes. (It comes with @strong{NO WARRANTY}!)
-@item -x, --no-double-dots,
- Assume no double dotted notes.
+@item -v, --version
+ Print version number.
+@item -w, --warranty
+ Show warranty and copyright.
+@item -x, --text-lyrics
+ Treat every text as a lyric.
@end table
etf2ly [@var{option}]@dots{} @var{etf-file}
@end example
-The following options are supported by etf2ly.
+The following options are supported by etf2ly:
@table @code
@item -h,--help
this help
@refbugs
The list of articulation scripts is incomplete. Empty measures confuse
-etf2ly.
+etf2ly. Sequences of grace notes are ended improperly sometimes.
@node Invoking abc2ly
ABC is a fairly simple ASCII based format. It is described at the abc site:
@quotation
-@uref{http://www.gre.ac.uk/~c.walshaw/abc2mtex/abc.txt}
+@uref{http://www.gre.ac.uk/~c.walshaw/abc2mtex/abc.txt}.
@end quotation
abc2ly translates from ABC to LilyPond. It is invoked as follows:
print version information.
@end table
-There is a rudimentary facility for adding lilypond code to the ABC
+There is a rudimentary facility for adding LilyPond code to the ABC
source file. If you say:
@example
@end example
This will cause the text following the keyword ``voices'' to be inserted
-into the current voice of the lilypond output file.
+into the current voice of the LilyPond output file.
-Similarly:
+Similarly,
@example
%%LY slyrics more words
on PMX is available from the following site:
@quotation
-@uref{http://icking-music-archive.sunsite.dk/Misc/Music/musixtex/software/pmx/}.
+@uref{http://icking-music-archive.org/Misc/Music/musixtex/software/pmx/}.
@end quotation
@cindex PMX
@refbugs
-musedata2ly converts only a small subset musedata.
+@file{musedata2ly} converts only a small subset of musedata.
@node Invoking mup2ly
@section Invoking mup2ly
@refbugs
-Currently, only plain notes (pitches, durations), voices and staves are
+Currently, only plain notes (pitches, durations), voices, and staves are
converted.