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 par-
       ticular	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  begin-
	      ning 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  prefer-
	      able 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)