MP3Extract V1.2 by Sascha 'SieGeL' Pfalz
-------------------------------------------------------------------------------
This is a FileID Builder for mailbox systems like FAME. It allows to read all 
MP3 infos from within the MP3 files and creates a FileId for it. It maybe also 
used as Info tool in a CLI.

REQUIREMENTS:
~~~~~~~~~~~~~

- Kickstart V2.04 or higher

- A MP3 file to check ;)


USAGE:
~~~~~~

      MP3Extract <FILENAME> [FILEID=<PATH/NAME>] [CONFIG=<FILENAME>]

Just enter in a CLI:
                           MP3Extract TEST.MP3

and it will display all available informations. If you wish to have a fileid
created out of these datas, enter the following:

                    MP3Extract TEST.MP3 FILEID=RAM:FILE_ID.DIZ

This will show the infos in your CLI window and creates also a FILE_ID.DIZ file
in your RAM: directory. The FileID looks like this:


LITTLEDR.MP3 P3655442  10-30-98  MP3 File:                      LITTLEDR.MP3
                                 --------------------------------------------
                                 Album   :
                                 Artist  : Boney M.
                                 Title   : Little Drummer Boy
                                 Year    :
                                 Comment :
                                 Standard: MPEG-1 Layer III / J-Stereo
                                 Length  : 4:21 mins [112KBit/s 44100Hz]


If you don't like this output, you have now the possibility to use your own
design. To use this feature, add the CONFIG Parameter to MP3Extract:

     MP3Extract TEST.MP3 FILEID=RAM:FILE_ID.DIZ CONFIG=MP3Extract.cfg

This will create the FileID in RAM: called FILE_ID.DIZ by using the
file MP3Extract.cfg config file. The following parameters are currently
supported:

---[SNIP]---

MP3 File : %P
Album    : %A
Artist   : %R
Title    : %T
Year     : %Y
Comment  : %C
Genre    : %G
Standard : %S
Mode     : %M
Length   : %L
Bitrate  : %B
Frequency: %F

---[SNAP]---

You may also look at the supplied configfile 'mp3extract.cfg'.

If you don't pass the CONFIG parameter, the internal design will be used.


USAGE WITH FAME (AS FILEID EXTRACTOR):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Start SystemEditor.

2. Go to File Checkers.

3. Create a new Filechecker called MP3 (and set it to ON of course!)

4. Enter as FileId Extractor: MP3Extract %F FILEID=%WFILE_ID.DIZ

5. Save these settings and done!


USAGE WITH BYTEANDIS FILEID EXTRACTOR:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Enter the following Tooltype in FileID.info:

             EXTERN_MP3_EX=MP3Extract %P FILEID=%WFILE_ID.DIZ

And Byti's tool is also able to extract it...


USAGE WITH 5D's FILEID EXTRACTOR:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

   MP3_EXTRACT=MP3Extract %F FILEID=%WFILE_ID.DIZ CONFIG=MP3Extract.cfg


GREETINGS:
~~~~~~~~~~

Here are the guys I want to greet:

Exon - For betatesting and giving some good suggestions for MP3Extract

CqBs - For beta-testing this thing

Ramses - Also for beta-testing

Strider - For his FAME System, which simply rocks!


CONTACT:
~~~~~~~~

If you wish to contact me, use the following addresses:

E-Mail: siegel@siegel.in-berlin.de

   WWW: http://www.in-berlin.de/User/siegel/index.html

   BBS: +49(0) 30 614 25 51 (X.75/ISDN only!)

   ICQ: 9691810