I assume that you read this file first before installing.

*************************************************************************
This is a beta-version of MP3-Ext. I am not responsible for any damage
this program does. Use it at your own risk.
*************************************************************************

My new email-address is: mutschler@aeon-shopping.de
but this one works too: mutschml@tick.informatik.uni-stuttgart.de
If you find any bugs, please let me know, since this is no
alpha version anymore...

Note: If it isn't working, try to install the new VisualC++ DLLs
available at the same directory as this extension, but with the
filename "msvcrt60.zip" (251kb). Unzip these two DLLs in your
Windows\system folder, and possibly reboot.

For all you NT users who have problems updating msvcrt.dll, I've
included a small program bootrename. With this tool you can move a
file during the next boot.

ID3V2-notes:
1. only a few tags are yet implemented
2. unsynchronization not supported yet, and probably will never be.
3. The short form of the TCON-Frame is not supported, neither is the writing
   of the char "(".
4. Actions are untested. Assume they aren't working.
5. The follwowing Frames are fully implemented:
   TIT2, TIT3, TPE1, TPE2, TPE3, TCOM, (TCON), TALB, TRCK, TYER, APIC
   The rest is just taken as it is. So no unknown frame will be deleted.
6. For padding, every new ID3v2 tag will get an additional 512 bytes.
7. I am writing an ID3v2.3 & ID3v1 tag by default.

What has changed since Version 2.3b6?
- ID3V2.3 support
- no string limitations anymore
- new Analyzer
- config of the actions has changed
- icon handler

Few notes to the icon handler:
- The Icon will be stored inside the MP3-file, as a "APIC"-frame, Type 0x02,
  and mime-type "image/ico".
- if the handler doesn't find an icon in the file, some internal icons are shown:
  1. if the bitrate of the MP3 is <96k then a red MP3-icon is displayed
  2. if the bitrate of the MP3 is 96k/112k/128k, a corresponding icon is displayed
  3. if the bitrate of the MP3 is >128k then a blue MP3-icon is displayed

>>>>>>>>>>>>>>>>> Icon designer needed <<<<<<<<<<<<<<<<<<<<<
If anybody likes to draw some nice icons, instead of mine 
(I admit, I am no good graphic artist), please feel free to 
send me them (mutschler@aeon-shopping.de). I will add the
nicest ones in the next version. Oh, you can make icons for
other bitrates too.
>>>>>>>>>>>>>>>>> Icon designer needed <<<<<<<<<<<<<<<<<<<<<


How does the new analyzer work?
Go to the config-page and select the Templates-Tab. There you
can configure the filename-analyzer. Now you can specify your own
templates based on regular expressions. The analyzer tries all the templates
on the filename (incl. path), and if it matches, it applies the substrings
to the according fields in the ID3-Tag, if they are empty.
If more than one template matches, then this procedure is done more than
once. So put the more complex templates at the top, and the general templates
at the bottom of the list.

The template:
They are simple regular expressions. If you want to match a specific field,
e.g. the track, then you must put the 3-char id3v2-identifier followed by a ':'
in the first part of a subexpression: (TRCK:[0-9]*). This would be converted
to the subexpression ([0-9]*), and if it matches, the part that matched
will be written to the track. For more information about Regular expressions
see the documentation to the rx.lib I am using, or in more detail check out
various documenation on UNIX-regex, or PERL-documentation.

!!!!!!!!!!!!!!!!!! Note: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!    In order to be platform-independent with the filename,
!!!    all backslashes are converted to normal slashes.
!!!    i.e. c:\temp\xx.mp3 -> c:/temp/xx.mp3
!!!!!!!!!!!!!!!!!! Note: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

The following fields are currently recognized:
TIT2: Title
TIT3: Opus
TPE1: Artist
TPE2: Conductor
TPE3: Orchestra
TCOM: Composer
TCON: Genre
TALB: Album
TRCK: Track
TYER: Year
COMM: Comment

Now some examples:
1. Match the filename as the title.
The title is TIT2. Since we need a subexpression,
lets start with a simple "(TIT2:.*)". This wint work, since we must match the
complete filename and path. So extend it to ".*/(TIT2:.*)\.mp3".

2. match the following: "path\artist-title.mp3"
Let us continue on the previous expression, and extend it with the artist:
".*/(TPE1:.*)-(TIT2:.*)\.mp3"

3. try and match the track:
A track consists of only numbers, so match any number of numbers:
".*(TRCK:[0-9]*).*mp3"

Since a track is handled as a string this would result in numbers of "01".
And to better match the track, limit the length to 2 numbers. First do the second
problem: ".*(TRCK:[0-9][0-9]).*mp3"
In order to remove the leading zero, you have to do 2 templates. the first one
takes care of the zero, and the second matches the other 2-digit numbers:
1. ".*0(TRCK:[0-9]).*mp3"
2. ".*(TRCK:[1-9][0-9]).*mp3"
You can put these two in one regex:
".*(0(TRCK:[0-9])|(TRCK:[1-9][0-9])).*mp3"

and if you want to match single numbers too, just make the leading zero of
template 1 optional:
".*(0?(TRCK:[0-9])|(TRCK:[1-9][0-9])).*mp3"

For a description of the regular expressions, see the file rx.info, taken from
the rx-lib I am using.

