

			MIDI Karaoke Words Extractor 1.0
			   (c)  Wojciech Kulasa, 1997


 1. DESCRIPTION

	Karaoke Words Extractor extracts songs' words from MIDI Karaoke files
 in form suitable for viewing and printing. MIDI Karaoke format is a form of
 MIDI format containing words, which are displayed during playing of Karaoke
 file (if you have Karaoke player, of course, for example Mark Feaver's
 Standard MIDI and Karaoke Player).
	The standard extension of MIDI Karaoke files is '.kar', but it's
 also possible that '.mid' files are in fact renamed Karaoke files. To
 cope with this, KWE performs file checking - files that are not recognized
 as Karaoke files won't be processed (if used on MIDI collection - it will
 extracts words from normal and renamed .kar files).


 3. STATUS

	KWE 1.0 is freeware. It can can be freely distributed provided that
 all files are distributed and no charge is made. You use this pogram on
 your own risk.


 2. USAGE

 This is a form of invoking the program from MSDOS command line:

	KWE [-options] <input_filename(s)> [output_path]


	   options - actually only one option is supported:
		     s : suppress empty lines
		     Almost all songs contain empty lines between verses.
		     With this options they aren't written. This may sometimes
		     improve readability or simply save space when printing.

 input_filename(s) - path and name of Karaoke file. You can use standard DOS
		     wildcards (*,?), for example: C:\KARAOKE\*.KAR,
		     \MIDS\KARAOKE\??mid.*, etc.

       output_path - specifies the target directory, where KWE stores output
		     files. If this directory doesn't exist, it will be
		     created by KWE. If it isn't specified, output files will
		     be stored in source directory.

	Output files have the same name as corresponding Karaoke files, but
 their extensions are changed to TXT (words from Karaoke file music.kar will
 be saved as music.txt. Existing files with the same name are overwritten
 _without_warning_.
	If you run KWE without any parameters, it shows a small help.
 Karaoke files often contain additional comments. These are also saved to
 output file as TITLE (usually song's title and author) and INFO (usually
 technical informations and comments).


 4. CONTACT

	Send comments to:
		Wojciech Kulasa
		fgf@kki.net.pl
		http://fgf.home.ml.org
