                                 MovieID
                               Version 1.02


This program identifies the file format of movie files and displays
information about them.  It identifies all popular movie file formats,
including AVI, DivX, ASF, WMV, MPEG-1, MPEG-2, QuickTime, and RealMedia.

The program was created for several reasons:

1.  To identify the format of a movie file that was named with an incorrect
    file name extension.  This program parses the file to determine the file
    format, and does not use the file extension.  Incorrect file extensions
    are frequently found on files downloaded over the internet.

2.  To identify the player and/or codecs needed to view a specific file.
    This program includes a database of all known video and audio compression
    formats, which should help you to determine the codec needed to display a
    particular file.  This is frequently a problem with files downloaded over
    the internet.

3.  To display some basic information about the file.  This is really just a
    bonus, and was not the original goal of this program.  But since the
    information is readily available, it is displayed to the user.  Not all
    file formats display all information, but the program displays any
    information it can easily find.

4.  To help diagnose MediaPlayer problems.  If your MediaPlayer configuration
    gets screwed up, this program will still work.  It doesn't use any multi-
    media system calls.  All file parsing is done by this program.

5.  To display information FAST.  You can get most of the same information
    by opening a file in the appropriate player application, but it usually
    takes longer and requires multiple steps.

-------------------------------------------------------------------------------

Installation:

This program is so simple that no installation program is needed.

Two versions of this program are included in the distribution package:

1.  movieid.exe     The console (command-line) version.
2.  movieidw.exe    The Windows (GUI) version.

The Windows (GUI) version is not really a true Windows program because it
doesn't have its own user interface.  Instead, it uses Windows Notepad to
display all of its output.  When you drag a file onto the "movieidw.exe"
program file, Notepad will pop-up with information about the file.

To install the Windows (GUI) version on your desktop, simply copy the files
"movieidw.exe" and "movieid.cdb" to any directory.  Then drag "movieidw.exe"
to your desktop (this will create a shortcut).  Now you can drag any movie
file onto the shortcut to display information about the file.  Pretty simple!

To use the console version, simply copy the files "movieid.exe" and
"movieid.cdb" to any directory in your PATH (the WINDOWS directory will work,
but is not recommended).  The command-line usage is as follows:

  MOVIEID filename

That's all there is to it!


Notes:

1.  The file NOTEPAD.EXE must be located somewhere in your system path in
    order to use the Windows (GUI) version of this program.

2.  The included "MovieID.pif" file can also be used as the target of a drag
    and drop to invoke the console version of the program.

-------------------------------------------------------------------------------

File Formats Detected:

                                 Typical File
Name                             Extension(s)   MIME Type
------------------------------   ------------   ----------------------------
Audio Video Interleaved (AVI)     .avi          video/x-msvideo
Advanced Systems Format (ASF)     .asf .wmv     video/x-ms-asf
MPEG-1 Video Elementary Stream    .mpg .mpeg    video/mpeg
MPEG-1 System Stream              .mpg .mpeg    video/mpeg
MPEG-1 Embedded System Stream     .mpg .mpeg    video/mpeg
MPEG-2 Video Elementary Stream    .mpg .mpeg    video/mpeg
MPEG-2 Program Stream             .mpg .mpeg    video/mpeg
QuickTime                         .mov          video/quicktime
RealMedia                         .rm           application/vnd.rn-realmedia


Information Displayed for Each File Format:

                                     Video  Video  Audio   Audio
           Video   Audio             Size   Frame  Sample  Bit    Audio
File Type  Codecs  Codecs  Duration  (WxH)  Rate   Rate    Rate   Channels
---------  ------  ------  --------  -----  -----  ------  -----  --------
AVI           *      *        *        *      *      *       *       *
ASF           *      *        *        *             *       *       *
MPEG-1        -     (2)      (1)       *      *      *       *       *
MPEG-2        -     (2)      (1)       *      *     (2)     (2)     (2)
QuickTime    (3)    (3)      (3)      (3)    (3)    (3)             (3)
RealMedia                     *        *      *              *

(1) = not available in some Video Elementary Streams
(2) = only detects MPEG audio streams (layers 1, 2, and 3)
(3) = not available on files with compressed headers

-------------------------------------------------------------------------------

License and Support:

MovieID is free to anyone who wants it.  Use it as you wish!  There are no
guarantees, but please let me know if you find any problems.  Thanks.

If you encounter any video or audio formats that are not in the database or
would like to recommend additional information for the database (such as codec
download sources), please let me know.  I plan to add more information to the
codec database when I have time.  If possible, please supply the following
information for each new video or audio format:

  1.  FourCC code or format ID
  2.  Format name
  3.  Format author (this may or may not be the codec author)
  4.  Format author's web site
  5.  Additional information, such as codecs that can decode this format

If you have any movie files that are not recognized by this program, please
let me know too.  It would help if you could make a copy of the movie file
available for me to test, but it's not absolutely necessary.  Please don't
send me any movies through the email!  Contact me first and we can arrange
something.

-------------------------------------------------------------------------------

Author/Contact Information:

  Christopher P. LaRosa
  cplarosa@yahoo.com
  http://www.geocities.com/cplarosa/movieid/

-------------------------------------------------------------------------------

Revision History:

Version 1.01:
 1.  Changed MPEG stream search length from 32K to 128K to support VCD files.
 2.  Added Data Rate display for ASF, AVI, and constant bit rate MPEG files.
 3.  Fixed the total time calculation for ASF files (subtract preroll).
 4.  Added content description display for ASF files.
 5.  Added the NOTEPAD.EXE invocation mode when compiled in GUI mode.

Version 1.02
 1.  Fixed a bug in ASF content description parsing.
