Documentation/user/convertors.itely

   1 @c -*-texinfo-*-
   2
   3 @node Conversion tools
   4 @chapter Converting to LilyPond format.
   5
   6 @section midi2ly
   7
   8 Midi2ly translates a MIDI input file to a LilyPond source file.
   9 Midi2ly is part of the GNU LilyPond music typesetting package.
  10
  11
  12 Human players usually are rhythmically not very exact when they record
  13 MIDI files.  midi2ly tries to compensate for these errors, but is not
  14 very good at this. It is therefore not recommended to use midi2ly for
  15 human-generated midi files. Correcting the quantization mistakes of the
  16 human player takes a lot of time.
  17
  18 Hackers who know about signal processing are invited to write  a more
  19 robust midi2ly.
  20
  21 @subsection Invoking midi2ly
  22
  23 @example
  24         midi2ly [options] midi-file
  25 @end example
  26
  27 @unnumberedsec Options
  28
  29 @table @code
  30 @item -b, --no-quantify,
  31     Write exact durations, e.g.: `a4*385/384'.
  32 @item -D, --debug,
  33     Print lots of debugging stuff.
  34 @item -h, --help,
  35     Show a summary of usage.
  36 @item -I, --include=@file{DIR},
  37     Add DIR to search path.
  38 @item -k, --key=ACC[:MINOR],
  39     Set default key.  ACC > 0 sets number of sharps; ACC < 0 sets number
  40     of flats.  A minor key is indicated by ":1".
  41 @item -n, --no-silly,
  42     Assume no plets or double dots, assume smallest (reciprocal) duration 16.
  43 @item -o, --output=@file{FILE},
  44     Set @file{FILE} as default output.
  45 @item -p, --no-plets,
  46     Assume no plets.
  47 @item -q, --quiet,
  48     Be quiet.
  49 @item -s, --smallest=N,
  50     Assume no shorter (reciprocal) durations than N.
  51 @item -v, --verbose,
  52     Be verbose.
  53 @item -w, --warranty,
  54     Show the warranty with which midi2ly comes. (It comes with @strong{NO WARRANTY}!)
  55 @item -x, --no-double-dots,
  56     Assume no double dotted notes.
  57 @end table
  58
  59
  60 @section etf2ly
  61
  62 @subsection Invoking etf2ly
  63 Usage:
  64
  65
  66
  67 @example
  68         etf2ly [OPTION]... ETF-FILE
  69 @end example
  70
  71 Convert ETF to LilyPond.
  72
  73 Options:
  74 @table @code
  75 @item   -h,--help
  76 this help
  77 @item  -o,--output=FILE
  78 set output filename to FILE
  79 @item  -v,--version
  80 version information
  81 @end table
  82
  83 Enigma Transport Format is a format used by Coda Music Technology's
  84 Finale product. This program will convert part of an ETF file to a
  85 ready-to-use lilypond file.
  86
  87 Report bugs to bug-gnu-music@@gnu.org
  88
  89 Written by  Han-Wen Nienhuys
  90
  91 [descibe abc2ly, pmx2ly, etf2ly, musedata2ly here]
  92