midicopy

MIDICOPY(1)                  General Commands Manual                 MIDICOPY(1)



NAME
       midicopy - Copy selected track, channel, time interval of a MIDI file to
       another MIDI file

SYNOPSIS
       midicopy [-ver] [-trks n1,n2,..] [-chans n1,n2,...]    [-from n (in midi
       ticks)] [-to n (in midi ticks)]    [-fromsec %f n (in seconds)] [-tosec n
       (in seconds)]    [-frombeat %f n (in beats)] [-tosec n (in beats)]
       [-replace trk,loc,val] input.mid output.mid

DESCRIPTION
       midicopy is used to copy part of a MIDI file to another MIDI file. You
       can select a particular time interval, particular channels, and
       particular tracks or any combinations. If one or both of the run time
       parameters -from or -to are included, the program returns the playing
       time in seconds of the output file.  Midicopy was developed by Seymour
       Shlien from the midifilelib distribution available from
       http://www.harmony-central.com/MIDI/midifilelib.tar.gz.

OPTIONS
       -ver   prints version number and then exits

       -trks n
              Selects the tracks to be copied where the track numbers start from
              1.  If more than one track is specified, they should be separated
              by commas. You should always copy track 1 since by convention it
              contains information pertinent to all the other  tracks. By
              default all tracks are copied unless you specify particular tracks
              using this run time parameter.

       -chns n
              Like above, it specifies the MIDI channels to be copied. By
              default all channels are copied. Channel numbers also start from
              1.

       -from n
              The program will copy all MIDI commands starting from midi pulse
              number n. By default it will start from time zero or the beginning
              of the MIDI file.

       -to n  Stops copying all events after midi pulse number n. By default the
              file is copied to the end.

       -frombeat n
              The program will copy all MIDI commands starting from quarter beat
              number n. By default it will start from time zero or the beginning
              of the MIDI file.

       -tobeat n
              Stops copying all events after quarter beat number n. By default
              the file is copied to the end.

       -fromsec n
              The program will copy all MIDI commands starting from time n in
              seconds.

       -tosec n
              Stops copying all events after time n in seconds. These two
              options (-fromsec and -tosec) do not work accurately if the MIDI
              file has more than one tempo command. Only the first one is used
              for converting seconds into MIDI pulse units.  It is therefore
              preferable to use the -from and -to options.

       -replace trk,loc,val
              This option should be used alone. Midicopy will copy the entire
              file verbatim except it will replace a byte by val, where the byte
              is located in the specified track (trk) and specified position
              (loc). Commonly this function is used for changing a particular
              MIDI program number (instrument) associated with a channel.  You
              need to know the byte count in the track of that parameter in
              order to use this function,

EXAMPLE
       midicopy.exe -trks 1,5 -from 2669 -to 8634 uzicko.mid fragment.mid
       Midicopy will copy tracks 1 and 5 starting from midi pulse position 2669
       and ending at MIDI pulse position 8634.


SEE ALSO
       abcmtex(1), abc2abc(1), abc2midi(1), midi2abc(1) ,yaps(1)

AUTHOR
       This manual page was written by Seymour Shlien.

VERSION
       This man page describes midicopy version 1.04 from September 19 2005.



                                                                     MIDICOPY(1)