This is the binary tarball of mpgedit 0.7 beta for Windows. This product has
been built using Microsoft Visual Studio 6.0. This build is known to
function on Windows 95 through Windows XP.  Please let me know about your
success/failure with running this code.

The release notes for this product are in "NEWS".


INSTALLATION
------------
This package has no installer.  Look at the Windows installer packages
for mpgedit and xmpgedit before considering placing any effort into
installing this package.

This package is the raw binary files distribution.  There is no "installer"
per se.  You are responsible for placing these files in the correct location,
setting PATH and the registry to properly find the executables on your system.

Unzip this package, and run from the current directory.  Your best bet is to
copy into some location like your PATH environment variable.


UNINSTALLATION
--------------
This is up to you, since the installation was done by you.


DOCUMENTATION
-------------
HTML versions of the mpgedit man pages are available on the mpgedit
home page:

    http://mpgedit.org/mpgedit/mpgedit.html


FILE LIST
---------
                                                       README.win32
-rw-r--r--    1 root     slocate    187245 Apr 17 00:10 ATrain23.mp3
-rw-r--r--    1 root     slocate     14962 Apr 17 00:10 NEWS
-rw-r--r--    1 root     slocate      2993 Apr 17 00:10 README
-rw-r--r--    1 root     slocate    121344 Apr 17 00:10 curses.dll
-rw-r--r--    1 root     slocate      6495 Apr 17 00:10 decoder_so.html
-rwxr--r--    1 root     slocate    229660 Apr 17 00:10 libmpgedit_decoder.dll
-rwxr--r--    1 root     slocate     45056 Apr 17 00:10 mp3_vbrpatch.exe
-rw-r--r--    1 root     slocate      1733 Apr 17 00:10 mp3decoder_sh.html
-rw-r--r--    1 root     slocate     28224 Apr 17 00:10 mpg1_layer1_fl1.mp3
-rw-r--r--    1 root     slocate     26332 Apr 17 00:10 mpg1_layer1_fl7.mp3
-rw-r--r--    1 root     slocate     30720 Apr 17 00:10 mpg1_layer2_fl11.mp3
-rw-r--r--    1 root     slocate     48384 Apr 17 00:10 mpg1_layer2_fl16.mp3
-rw-r--r--    1 root     slocate     23328 Apr 17 00:10 mpg2_layer2_test24.mp3
-rwxr--r--    1 root     slocate    248168 Apr 17 00:10 mpgedit.dll
-rwxr--r--    1 root     slocate    276432 Apr 17 00:10 mpgedit.exe
-rw-r--r--    1 root     slocate     40745 Apr 17 00:10 mpgedit.html
-rwxr--r--    1 root     slocate    192472 Apr 17 00:10 mpgedit_nocurses.exe
-rw-r--r--    1 root     slocate     26421 Apr 17 00:10 mpgtests.pm
-rw-r--r--    1 root     slocate      1024 Apr 17 00:10 ones_data
-rw-r--r--    1 root     slocate      1101 Apr 17 00:10 random_prefix
-rwxr-xr-x    1 root     slocate      2225 Apr 17 00:10 scramble.pl
-rw-r--r--    1 root     slocate      3366 Apr 17 00:10 scramble_pl.html
-rwxr-xr-x    1 root     slocate      1193 Apr 17 00:10 scramble_times.pl
-rw-r--r--    1 root     slocate      1974 Apr 17 00:10 scramble_times_pl.html
-rw-r--r--    1 root     slocate     48189 Apr 17 00:10 test1.join
-rw-r--r--    1 root     slocate    596332 Apr 17 00:10 test1.mp3
-rwxr-xr-x    1 root     slocate     25792 Apr 17 00:10 test1.pl
-rw-r--r--    1 root     slocate     42976 Apr 17 00:10 test1.split
-rw-r--r--    1 root     slocate    155776 Apr 17 00:10 test2.mp3
-rwxr-xr-x    1 root     slocate      1284 Apr 17 00:10 test2.pl
-rw-r--r--    1 root     slocate       128 Apr 17 00:10 test2.tag
-rwxr-xr-x    1 root     slocate       108 Apr 17 00:10 test3.pl
-rwxr-xr-x    1 root     slocate      1952 Apr 17 00:10 test4.pl
-rwxr-xr-x    1 root     slocate       681 Apr 17 00:10 unscramble.pl
-rw-r--r--    1 root     slocate      2113 Apr 17 00:10 unscramble_pl.html
-rw-r--r--    1 root     slocate       208 Apr 17 00:10 xingheader.mp3
-rw-r--r--    1 root     slocate       947 Apr 17 00:10 zero_prefix

      MD5 Checksum                    File Name
      ------------                    ---------
                                  README.win32
512e9b599d372580b7c8ce04ea426f7c  ATrain23.mp3
609aa2a029a2225ab395da6dc5d457d8  NEWS
41fbce622382f804e31961a2df7cee53  README
d5a933ee905e667580b25887645f891f  curses.dll
1e937d0710912955a6102b53da9db676  decoder_so.html
d686f01acc323e4460c1204b1cdbd04d  libmpgedit_decoder.dll
5f375a93417258c6684694328f0b6baa  mp3_vbrpatch.exe
5c8bc39bcf18390a54ad11a336bf3b0d  mp3decoder_sh.html
7329613f3a27878472c475406a56cbe8  mpg1_layer1_fl1.mp3
e78f88a9ac1a4f16f675f875ae3bdbfe  mpg1_layer1_fl7.mp3
b00a270cd7d60679e25cfda40acac423  mpg1_layer2_fl11.mp3
7646f3b219ed576b9f3b166c1012a5d6  mpg1_layer2_fl16.mp3
375b248baae67f7de055734b418c22af  mpg2_layer2_test24.mp3
5250300461634ba4a7da7c3b5fe3c8d8  mpgedit.dll
51ad8cf4b0daeb39c1bd5a94001793f9  mpgedit.exe
7b1a50d95cc3dec2d293db30c5281ef7  mpgedit.html
b156899d1d1bda191c26fdea9788ff7d  mpgedit_nocurses.exe
83dc8e661fd7a1a4aed6f54194691be2  mpgtests.pm
54ac58cc1e2711a1a3d88bce15bb152d  ones_data
012d7426c85fdfadf543f302c5c67d60  random_prefix
688a932175e6fdd1e35259664cb5c902  scramble.pl
e77e774b1f469fbcca0e397a1a57fdb6  scramble_pl.html
246b36a89d86b3567de4a5cb19acf7fe  scramble_times.pl
4a7c502c9105ed69e2c0cb23c8832d2c  scramble_times_pl.html
38c967b1c58e8732bac2fd4947673e9f  test1.join
8bf58c3868a8bc51f38bc77dab649983  test1.mp3
36607b821278701d0bb852e8f435da3c  test1.pl
d955eedf2be6dc2b7e88f882ac878d59  test1.split
4978c8774ec827d72d6744f9a072588e  test2.mp3
489d1f7d70fe33993c278c65f0509569  test2.pl
14bad65c7495d852c44bdd956bfad37b  test2.tag
d14295f65777dceb6f1b5c22bbb39b92  test3.pl
e60f1da674770dfbd0e9584449cd7a31  test4.pl
19986fe4df46ed813a4341789fd2779a  unscramble.pl
c37642ee8dde9a571668318d46846d99  unscramble_pl.html
7525e8524bca1e0583ec6c8aea3764df  xingheader.mp3
3676e04cd30ad97e0534f53d580be89a  zero_prefix


TESTING
-------
The current regression test is "test1.pl".  You can run the regression
test by simply executing:

UNIX:    $ ./test1.pl
Windows: C:> test1.pl

This test heavily exercises the editing features of mpgedit.  Each test
performs a series of edits that results in an output file that will be
identical to the original, unedited file.  The resultant edited file is
then compared against the original source file.

The regression test scripts are written in Perl, and run on Win32.
You must have the Perl environment installed before you can run these
tests.  Perl can be downloaded here from the ActivePerl web site:

    http://downloads.activestate.com/ActivePerl/Windows/5.6/ActivePerl-5.6.1.633
-MSWin32-x86.msi

Without Perl installed, the full regression test suite cannot be run.
However, the "slice and splice" test is available, in a fashion, for all
platforms.

The slice test is performed with the following actions:

  - Start mpgedit with no options
  - Press 'Enter' to close the help window
  - Enter the 'L' command, then load "test1.split"
  - Enter the 'E' command, save abandoned edits to file "test1.split2

The splice test is performed with the following actions:

  - Start mpgedit with no options
  - Press 'Enter' to close the help window
  - Enter the 'L' command, then load "test1.join"
  - Enter the 'n' command, entering the output file "test1_splice.mp3"
  - Enter the 'e' command, save abandoned edits to file "test1.join2"

Files test1.mp3 and test1_splice.mp3 should be identical.  This can be
verified by comparing these two files with diff:

  cmp test1.mp3 test1_splice.mp3

Cleanup after this test with the following command:

  rm -f test1.splice.mp3 test1_*.mp3 test1_*.idx test1.split2 test1.join2


SOURCE CODE
-----------
CVS:

cvs -d   :pserver:anonymous@mpgedit.org:/usr/local/cvsroot login

       There is no password, just press Enter

cvs -z3 -d   :pserver:anonymous@mpgedit.org:/usr/local/cvsroot   co -r latest mpgedit


COMPILING
---------
You must have Visual C++ configured for command line builds.  The
easiest way to accomplish this is run vcvars32.bat from a cmd shell.

Download the source:
    http://mpgedit.org/mpgedit/mpgedit_0-7beta_src_tgz.zip

Or download the source from CVS for 'latest'. 

In a directory at the same level as the mpgedit source,
download the PDCurses 2.4 package and unzip it in a directory
named 'pdcurses'. 

The build of xmpgedit is dependent on GTK+ 2.0 for Windows.  This
can be downloaded from:

  http://www.gimp.org/~tml/gimp/win32/downloads.html


These packages are needed to build:
  atk-dev-1.0.3-20020821.zip
  glib-dev-2.2.1.zip          
  gtk+-dev-2.2.1.zip 
  libiconv-1.8-w32-1.bin.zip
  pango-dev-1.2.1.zip

The makefile for xmpgedit expects these to be installed in:

  C:\win32\tools\gtk

The makefile must be adjusted if these packages are installed elsewhere.

You should have a directory structure something like this:

    c:\wrk\mpgedit
    c:\wrk\pdcurses
    c:\win32\tools\gtk

From a cmd shell, cd into wrk\mpgedit, and run win32_make.bat.

c:\mpgedit> win32_make.bat


COPYRIGHT
---------

     mpgedit - MPEG 1/2/2.5 (MP3) audio file editor
               Version __MAJOR__.__MINOR__ __RELTYPE____CKPOINT__ __MONTH__ __DAY__, __YEAR__
                   http://mpgedit.org
        Copyright (C) 2001-__YEAR__ by Adam Bernstein


Written by: Adam Bernstein <number6@mpgedit.org>, released under
the GPL.  See "COPYING" for full details.

The mpgedit audio playback plugins uses the MPGLIB decoding engine,
from the MPG123 package, written by: Michael Hipp (www.mpg123.de)
MPGLIB is released under the GPL.

The version of MPGLIB used in this release comes from LAME 3.90 alpha 7,
released under the GNU LESSER PUBLIC LICENSE.

Copyrights (c) 1999,2000,2001 by Mark Taylor: LAME
Copyrights (c) 1998 by Michael Cheng: LAME
Copyrights (c) 1995,1996,1997 by Michael Hipp: mpglib

curses.dll comes from the PDCurses 2.4 package (pdc24_vc_w32.zip),
http://pdcurses.sourceforge.net/index.html

The Gimp Toolkit (GTK) is used by xmpgedit, http://gtk.org.

The Win32 installer uses Inno Setup (IS), Copyright (C) 1997-2003++
Jordan Russell (http://www.jrsoftware.org/isinfo.php)

The MD5 checksum library (http://sourceforge.net/projects/libmd5-rfc/)
is Copyright (C) 1999, 2000, 2002 Aladdin Enterprises.  
All rights reserved.

The libdecoder_mad.so playback plugin is implemented using libmad,
libmad - MPEG audio decoder library, Underbit Technologies, Inc.
Copyright (C)  2000-2004 Underbit Technologies, Inc.
http://www.underbit.com/products/mad/

The getopt.c win32/getopt.h sources are originally from GNU getopt,
Copyright (C) 1987, 88, 89, 90, 91, 92, 1993, Free Software Foundation, Inc.

audio_macosx.c: originally written by Guillaume Outters. AudioUnit version 
by Steven A. Kortze <skortze@sourceforge.net>

audio_aix.c: Code by Juergen Schoew <juergen.schoew@unix-ag.org>;
Tomas Oegren <stric@acc.umu.se>, (code for audio_close delay);
Cleanups and testing by Niklas Edmundsson <nikke@ing.umu.se>.

audio_hp.c, audio_oss.c, audio_win32.c, audio_sun.c: No attributions 
present in source code.  Originally part of mpg123 project, copyrights 
(c) 1995,1996,1997 by Michael Hipp.

As well as additional copyrights as documented in the source code.


